Skip to main content
POST
Create device

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string | null

At-most-once key for the create

Body

application/json

The create-device request body. Every field is optional; an org-wide key MUST carry space_id, a Space-scoped key holding exactly one Space may omit it.

idle_suspend_secs
integer<int32> | null

Per-device idle-suspend threshold in seconds; null uses the deployment default.

name
string | null

Human label; defaults to a generated operator-device name.

region
string | null

Sprite region; defaults to ord.

space_id
string | null

Raw uuid of the target Space.

Response

The provisioned device

A device as returned on the /v1 surface. id/current_task_id carry the dev_/task_ prefixes (the bare uuids never leave the DB); space_id is a raw uuid (Spaces are not an Operator concept).

created_at
string
required
id
string
required

dev_<uuid>.

name
string
required
object
string
required

Discriminator for polymorphic SDK decoders. Always "device".

region
string
required
space_id
string
required
status
string
required
current_task_id
string | null

task_<uuid> of the task currently holding the device, or null when idle.

last_active_at
string | null