Create a monitors relation (or update the existing one) between a role and a device. To execute this query, the user must be a member of an authorizing role which satisfies both of the following conditions: One of the following role-related conditions is true: The authorizing role has direct or indirect deviceManagement rights for the role from which the monitors relation is created (or updated) The authorizing role has indirect roleManagement rights for the role from which the monitors relation is created (or updated) The authorizing role has monitorManagement rights for the device to which the monitors relation is created
accessBearerAuth In the value field below, fill in the access token. It has a 10 minutes validity period. A valid token can be obtained via the /accesstoken endpoint (call), AFTER authorization with refreshBearerAuth and the refresh token.
In: header
Id of the role of the newly created (or updated) monitors relation
0 <= valueId of the device the newly created (or updated) monitors relation
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/role/0/monitors?deviceId=0" \ -H "Content-Type: application/json" \ -d '{ "monitorManagement": true, "reads": [ "string" ], "edits": [ "string" ] }'{ "monitors": { "id": 0, "roleId": 0, "deviceId": 0, "monitorManagement": true, "reads": [ "string" ], "edits": [ "string" ] }}Collect monitors relations POST
Get all (or some of) the monitors relations which start from a role of which a user is a member (either directly or indirectly).
Update an existing monitors relation PUT
Update an existing monitors relation.<br><br> To execute this query, the user must be a member of an authorizing role which satisfies both of the following conditions: <ol> <li> One of the following role-related conditions is true: <ul> <li> The authorizing role has *direct or indirect* deviceManagement rights for the role from which the monitors relation is updated </li> <li> The authorizing role has *indirect* roleManagement rights for the role from which the monitors relation is updated </li> </ul> </li> <li> The authorizing role has monitorManagement rights for the device to which the monitors relation is updated </li> </ol>
Indicates whether the role has the right to create new monitors relations to the monitored device. If true, the role may read and edit any device property.
A list of device properties which may be read by the role monitoring the device
A list of device properties which may be both read and edited by the role monitoring the device