Shadows
Updates a device shadow
Updates the trackingId device desired shadow.
The device shadow consists of reported and desired shadows. Only the desired shadow can be updated via this endpoint. The reported shadow is updated automatically when the device sends telemetry to the ingestion endpoint.
put/shadows/v2/{trackingId}
Path parameters
trackingIdstring required
This is a unique ID associated with the device data in HERE Tracking. For physical devices the trackingId gets assigned to a device when the device is claimed by a user, and for virtual devices it is an external device ID along with the device project appId.
Headers
content-lengthnumber required
The size of the shadow in bytes. The size is validated against the maximum limit of 1000 bytes.
Request body
Response
Success
Example response
{
"reported": {
"system": {
"client": {
"accelerometerSensorRange": [
2
],
"diagnosticscode": 0,
"diskquota": 256,
"firmware": "heroltexx...",
"hasAccelerometerSensor": true,
"hasAttachSensor": true,
"hasHumiditySensor": true,
"hasNoBattery": false,
"hasPressureSensor": true,
"hasTamperSensor": true,
"hasTemperatureSensor": true,
"homenetwork": [],
"manufacturer": "Samsung",
"model": "SM-G930F",
"name": "HERE Tracker",
"platform": "Android",
"version": "1.6.1"
},
"imsi": "123456789012345",
"phoneNumber": "+491234567890"
}
}
}