Request ‒ Devices/UpdateSettings
Property
Type
Description
Mandatory
settings
Array of Objects
Settings is an array of setting properties. Each setting property represents an IoT Platform Device object property to be modified on a physical Device in order to affect its functionality.
“settings”: [
{
“name”: “string”,
“desiredValue”: “string”

“reportedValue”: “string”,
“lastSync”: “2018-08-24T11:14:32.000Z”,
“version”: 0
}
settings/name
String
A free-text name for the property. This name must be recognized and handled on the physical Device.
settings/desiredValue
String
The value to be assigned to this property on the physical Device.
settings/reportedValue
String
The value received from the updated physical Device by the IoT Platform Device SDK as the updatedValue, after it has been updated. This value should be the same as the desiredValue (described above).
settings/lastSync
DateTime
The last timestamp when a reading was received from the Device.
settings/version
Integer
Not in use.
Example JSON Devices/UpdateSettings Request
curl -X POST \
https://api.dev.axonize.com/odata/devices/5953a14cb637f914dcbf75fd/updatesettings \
-H ‘Content-Type: application/json’ \
-H ‘appId: 2925e8b9-259c-1234-afed-80a20d123456’ \
-H ‘Authorization: Token’ \
-d ‘{
“settings”: [
{
“name”: “temperature”,
“reportedValue”: “40”,
“lastSync”: “2018-08-19T12:50:03.363Z”,
“version”: 0
}
]
}’