Partially update device

patch

https://api.sensos.io/v1/accounts/{accountId}/devices/{deviceId}

Partially update a device's name, configuration or set assignment. Returns the updated device.

Update semantics

A field that is omitted or sent as null is left unchanged.
configuration is not merged: when sent, it replaces the device's whole configuration object. For a Smart Label it must therefore include flightModeEnabled and reportConfiguration, plus every optional setting you want to keep.

Set assignment (setId)

If the device already has a configuration, setId is stored as provided. The set is not checked for existence and its configuration is not applied to the device.
If the device has no configuration yet, the set is validated (400 Bad Request if it does not exist) and the set's configuration is applied to the device.

BLE Tags

Only configuration can be updated, and it is required. Sending name or setId for a BLE Tag returns 400 Bad Request.

Responses

401

Unauthorized. The access token is missing, invalid or expired. Returned by the gateway with an empty body.

403

Forbidden. The caller lacks permission, or the account is unknown, belongs to another tenant or is inactive. Returned by the gateway with an empty body.

200Success. Returns the updated device.

400Bad Request. The payload is invalid, the configuration does not match the device type, the set does not exist (device without a configuration), or a field other than configuration was sent for a BLE Tag.

404Not Found. The device does not exist in this account.

412Precondition Failed. The device was modified concurrently; retry the request.