Create device type

POST

/api/device-types

curl --request POST \
  --url http://localhost:3000/api/device-types \
  --header 'Content-Type: application/json' \
  --cookie session=<session> \
  --data '{ "name": "example", "slug": "example", "manufacturerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "description": "example", "modelFamily": "example", "formFactor": "fixed", "rackUnits": 1, "airflow": "front-to-back", "weightKg": 1, "powerIdleW": 1, "powerMaxW": 1, "poeBudgetW": 1, "keyFeatures": "example", "typicalDeployment": "example", "asicChipset": "example", "defaultPlatformId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "defaultRoleId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "popular": false }'

• Local development
• Dedicated / self-hosted instance

Authorizations

• cookieAuth

Request Body ^required

Media type application/json

object

name

required

string

slug

Auto-generated from name when omitted

string

manufacturerId

string format: uuid

description

string

modelFamily

string

formFactor

string

Allowed values: fixed stackable modular-chassis half-rack compact 0.5U 1U 1.5U 2U 3U 4U 5U 7U 10U 13U 16U 21U

rackUnits

number

airflow

string

Allowed values: front-to-back back-to-front reversible side-to-side passive

weightKg

number

powerIdleW

integer

powerMaxW

integer

poeBudgetW

integer

keyFeatures

string

typicalDeployment

string

asicChipset

string

defaultPlatformId

string format: uuid

defaultRoleId

string format: uuid

popular

boolean

Responses

201

DeviceType created

Media type application/json

object

data

object

id

required

string format: uuid

name

required

string

slug

string

nullable

manufacturerId

string format: uuid

nullable

description

string

nullable

modelFamily

string

nullable

formFactor

string

nullable

rackUnits

Numeric(4,1) serialised as string

string

nullable

airflow

string

nullable

weightKg

Numeric(7,2) serialised as string

string

nullable

powerIdleW

integer

nullable

powerMaxW

integer

nullable

poeBudgetW

integer

nullable

keyFeatures

string

nullable

typicalDeployment

string

nullable

asicChipset

string

nullable

defaultPlatformId

string format: uuid

nullable

defaultRoleId

string format: uuid

nullable

popular

boolean

source

string

Allowed values: vendor customer

status

string

Allowed values: active announced eos eol

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

Example

{
  "data": {
    "source": "vendor",
    "status": "active"
  }
}

400

Validation error

Media type application/json

object

error

required

string

Example

{
  "error": "Not found"
}

401

Not authenticated

Media type application/json

object

error

required

string

Example

{
  "error": "Not found"
}