Skip to main content
POST
Update devices in a batch
The update runs as a job. The request is checked for shape, a job is created, and the response returns that job. Poll Get a job with the job _id until status is COMPLETED, FAILED or CANCELED. Each item has the device id and any of the fields of Update a device. Fields you leave out keep their current value. Send each id once.
The job checks that every device exists in the building. If any id is unknown or belongs to another building, the job ends with FAILED and no device is changed. After a COMPLETED job, read the devices to confirm the new values.

Authorizations

Authorization
string
header
required

Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.

Path Parameters

buildingId
string
required

Building identifier from List buildings.

Body

application/json
items
object[]
required
Required array length: 1 - 1000 elements

Response

The job was accepted. Its status is PROCESSING.

_id
string
organizationId
string
createdAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

updatedAt
string
read-only

Date and time in UTC, with a numeric offset and no colon, for example 2026-10-28T13:51:31+0000.

Example:

"2026-10-28T13:51:31+0000"

name
string
description
string
status
enum<string>
Available options:
PENDING,
PROCESSING,
PROCESSED,
COMPLETED,
FAILED,
CANCELED
errorMessage
string