put
https://{url}/v1/devices/
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.
Update device information on the server.
Request Data
| Name | Type | Description |
|---|---|---|
| firmware_version | string | Current device firmware version |
| name | string | Friendly device name |
| sub_model | string | Device sub model |
| details | Object | Details of the device. Will be visible in a different tab on the device's view calls 'Details'. |
| space_version | string | Latest version of the space information the device has applied |
| config_version | string | Latest version of the configuration the device has applied |
| parent_id | uuid | Allow devices to change their parent. * |
| host_address | string | IP/Hostname of the device. |
Notes
parent_idDevices may set/change their parent_id to the UUID of a different devices as long as both belong to the same Partner and both are either unclaimed or claimed under the same Customer account.
Throttling
It is recommended to not use it more than 10 time a day and not to perform the call if no changes were done to the device.
The current throttling setting is at 10 calls per hour and might be decreased to 30 per day in the future.
When a device makes more that the limit of calls in a window, the request will not be performed and the server will return the response code 429