Create device
Create + provision an Operator device. Runs the write gate (scope + entitlement), resolves the
target Space (org-wide key: space_id required + Space check; Space-scoped key: its held Space),
enforces the device-count and rolling-duration quotas, provisions the device sprite, and returns
the active device (201). Idempotency-Key replays a prior success and 409s a reused key + a
different body.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
At-most-once key for the create
Body
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.
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).
dev_<uuid>.
Discriminator for polymorphic SDK decoders. Always "device".
task_<uuid> of the task currently holding the device, or null when idle.