put
https://{url}/v1/devices//space/move
This API can used by devices if they need to relocate within the Customer's heirarchy.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Use the hub_url received in the registration response as your base URL.
This API requires the device to authenticate, see Device Authentication.
Request Data
| Name | Type | Description |
|---|---|---|
| target | string | follow_parent or unsorted |
The following target parameters are supported:
follow_parentValid only for child devices with a Parent Device. This call will move the device to the same Space the parent is in.unsortedWill move the device to a special "Unsorted" space in the root tree of a Customer.
This API can only be called for Claimed devices.
Return Data
The Space the device is after the move.
{
"location": {
"coordinates": {
"lat": 51.165691,
"lng": 10.451526
},
"utc_offset": 60,
"name": "Germany"
},
"temperature_units": "celsius",
"maintenance": false,
"name": "Interactive Class",
"local_time": "2022-03-17T10:55:28+01:00",
"device_id": "fbe103c8-..."
}| Key | Subkey | Subkey | Type | Description | Model API Version |
|---|---|---|---|---|---|
| location | object | NULL if not set | 1.0.1+ | ||
| coordinates | object | 1.0.1+ | |||
| lat | float | Latitude | 1.0.1+ | ||
| long | float | Longitude | 1.0.1+ | ||
| utc_offset | number | Offset in minutes from UTC | 1.0.1+ | ||
| name | string | Location's name | 1.0.1+ | ||
| 1.0.1+ | |||||
| temperature_units | string | Temperature units for the space | 1.0.1+ | ||
| maintenance | boolean | Indicates whether the space is in maintenance mode | 1.0.1+ | ||
| name | string | Space name | 1.0.1+ | ||
| local_time | date | Local time of the space | 1.0.1+ | ||
| device_id | string | Device ID | 1.0.7+ |
