Skip to main content
PUT
Update a device
Send only the fields you want to change. The device id comes from the path.
The response is built from the saved device, so curStatus is null. Call Get a device for the current status.
To change many devices in one request, use Update devices in a batch.

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.

deviceId
string
required

Device identifier.

Body

application/json
name
string
locatedIn
string
location
string
metadata
object

Response

The updated device.

_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"

area
object
pointsCount
integer<int32>
building
object
connector
object
name
string
curStatus
enum<string>
Available options:
ok,
disabled,
fault,
no_value,
down
type
object
ontology
object
originType
enum<string>
Available options:
ORIGIN,
VIRTUAL,
MANUAL
pseudoDevice
boolean
metadata
object