A user can only execute this call is he is a member of an authorizing role which satisfies one of the following conditions: The authorizing role has direct or indirect deviceManagement rights for the role for which a device is created The authorizing role has indirect roleManagement rights for the role for which a device 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 to which the device (and monitors relation) should be added
0 <= valueBefore creating a new device, validate the properties using the schema corresponding to its nodeType (if such a schema exists)
application/json
The newly create device object
TypeScript Definitions
Use the request body type in TypeScript.
The newly create device object
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/device?roleId=0" \ -H "Content-Type: application/json" \ -d '{ "properties": { "property1": null, "property2": null } }'{ "monitors": { "id": 0, "roleId": 0, "deviceId": 0, "monitorManagement": true, "reads": [ "string" ], "edits": [ "string" ] }, "device": { "id": 0, "lastUpdate": "2019-08-24T14:15:22Z", "properties": { "property1": null, "property2": null }, "userRights": { "propertyEditabilities": { "property1": true, "property2": true }, "monitorManagement": true } }}Perform a series of targeted update operations on several devices PATCH
Patch the properties of several devices at once by specifying JSON patch operations in accordance with RFC 6902, each of which names the device or devices it applies to. The operations of a device are applied in their order in the request, and all devices are updated together or not at all. The same rights apply as for patching a single device. A failed operation is reported by its index in the request.
Collect devices POST
Get all (or some of) the devices which are monitored by roles of which the user is a member