Skip to main content
POST
Submit device states

Authorizations

Authorization
string
header
required

Bearer token obtained from POST /auth/tokens.

Body

application/json

Device state samples for many devices in one call.

data
DeviceStateSubmit · object[]
required

One sample per entry, up to 1,000. Each entry is a device state submission with its device_id.

Required array length: 1 - 1000 elements

Response

Device state batch response.

The result of a device state batch. Accepted samples are stored; each rejected one is listed with why.

object
enum<string>
required

Object type, device_state_batch.

Available options:
device_state_batch
Example:

"device_state_batch"

live_mode
boolean
required

true for live data, false for test data.

accepted_count
integer
required

Samples stored.

Example:

998

rejected
object[]
required

Samples not stored, with the reason. Empty when every sample was stored.

time_created
string<date-time>
required

Time when the batch was received, in UTC.

Example:

"2026-08-04T16:00:05Z"