Virtual devices
Create a virtual device
Creates an empty virtual device in a building. A virtual device groups points that come from other devices.
POST
Create a virtual device
Only
name is required. The server generates the id, sets the device as virtual, and starts it with no points. A body _id, building, originType or pointIds is ignored. Sending the same name again creates a second device.
The response has these members: id, name, type (id and name), locatedIn (id and name), area (id and name), location, pointsCount, createdAt and updatedAt. type, locatedIn, area and location are empty when you did not send them. area is the level of the space in locatedInSpaceId.
nameis trimmed and can be up to 255 characters.typeIdis the device type. Take it fromtype._idof an existing device. Up to 128 characters.locatedInSpaceIdis theidof a space in this building. Up to 128 characters.
Authorizations
Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.
Path Parameters
Building identifier from List buildings.
Body
application/json
Required string length:
1 - 255Pattern:
(?s)(?=.*[^\p{C}\p{Z}])[\P{Cc}\n\r\t]*Maximum string length:
128Pattern:
[^\p{C}\p{Z}]{1,128}Maximum string length:
128Pattern:
[^\p{C}\p{Z}]{1,128}Maximum string length:
255Pattern:
(?s)(?=.*[^\p{C}\p{Z}])[\P{Cc}\n\r\t]*Response
The created virtual device.

