Sign in

v1

latestOpenAPI 3.0.0HERE Documentation License2026-07-142162791.8 MB
Metadata

Creates or updates metadata of a device or a shipment

Updates the metadata object of the device or a shipment identified by the trackingId or the shipmentId. The metadata specified in the request body is merged with the existing metadata object (or gets created if no metadata object exists); new keys are added, and the values of the existing keys are updated with the new data. Adding 'null' value for a key deletes it from the metadata object. Successful response body contains the updated metadata object.

put/metadata/v2/devices/{trackingId}

Request body

object required

Response

Successful

The metadata was successfully updated.

dataobject required

Metadata JSON object

idstring 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. Alternatively, a valid shipmentId may be used.

Example response

{
  "data": {
    "priority": "high"
  }
}