Create Device Type

POST 
/api/v1/device-types

Registers a new device type in the hierarchy catalog. Requires the MANAGE_DISCOVERY role.

Request

application/json

Body

required

name stringrequired

Name of the device type

description string

Description of the device type

os string

Possible values: [android, windows, linux, macos]

Operating system of the platform

cpuArchitecture string

Possible values: [X86_64, ARM64]

cpuCount number

Number of vCPUs

memoryMb number

Memory size in MB

diskGb number

Disk size in GB

diskType string

Possible values: [HDD, SSD, NVME]

networkType string

Possible values: [NAT, BRIDGED, HOST_ONLY, CUSTOM]

imageId string

Optional image ID

metadata object

Optional tags or metadata

Responses

201

application/json

Schema

Schema

name stringrequired

Name of the device type

description string

Description of the device type

os string

Possible values: [android, windows, linux, macos]

Operating system of the platform

cpuArchitecture string

Possible values: [X86_64, ARM64]

cpuCount number

Number of vCPUs

memoryMb number

Memory size in MB

diskGb number

Disk size in GB

diskType string

Possible values: [HDD, SSD, NVME]

networkType string

Possible values: [NAT, BRIDGED, HOST_ONLY, CUSTOM]

imageId string

Optional image ID

metadata object

Optional tags or metadata

id numberrequired

ID of the device type

createdAt date-timerequired

Timestamp when the device type was created

updatedAt date-timerequired

Timestamp when the device type was last updated

Example (from schema)

{
  "name": "string",
  "description": "string",
  "os": "windows",
  "cpuArchitecture": "X86_64",
  "cpuCount": 0,
  "memoryMb": 0,
  "diskGb": 0,
  "diskType": "HDD",
  "networkType": "NAT",
  "imageId": "string",
  "metadata": {},
  "id": 0,
  "createdAt": "2026-11-08T13:48:43.664Z",
  "updatedAt": "2026-11-08T13:48:43.664Z"
}

Loading...