Device

Perform a series of targeted update operations

Patch the properties of one or more devices by specifying JSON patch operations which should be applied to the device properties in accordance with RFC 6902. A user can only execute this call when is he is a member of an authorizing role such that this role has a monitors relation with monitorManagement rights. Alternatively, the user must be member of a set of roles with monitors relations for the specified device, such that the set of device properties which these relations allow to edit are a subset of the device properties which are specified in the current request.

patch/v1/device/{deviceId}

Path parameters

integer required
OR
integer[] required

Id of the device or devices which we want to edit

Query parameters

validateboolean

Before executing the update, validate the updated device using the schema corresponding to its nodeType (if such a schema exists)

Headers

If-Unmodified-Sincestring

An ISO 8601 time or a time of the format '<day-name>, <day> <month> <year> <hour>:<minute>:<second> GMT', specifying the latest timestamp any of the affected devices might have received an update in order for the request to be executed. A code 412 error will be returned if at least one device was updated after the specified time

Request body

Response

The readable and editable properties of the device, as well as information regarding the editabilities of those properties and whether the user has monitorManagement rights for the device

Changes