---
title: "Clears a device shadow"
method: DELETE
path: "/shadows/v2/{trackingId}"
tags: ["Shadows"]
---

# Clears a device shadow

`DELETE /shadows/v2/{trackingId}`

Deletes the device shadow of the `trackingId` device.

By default, all the values of the `desired` and `reported` shadow objects will be cleared, leaving them empty.

If either `desired` or `reported` query parameter is set to `false`, that part of the shadow remains as it is.

## Path parameters

- `trackingId` string, 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`.

## Query parameters

- `desired` boolean
- `reported` boolean

## Response `204`

Successful (no content)

## Other responses

- `400` — Bad request The request object is in an incorrect format or has values that are invalid or out of range. If available, further error details are provided in the response body.
- `401` — Unauthorized The request did not provide correct authentication details
- `403` — Forbidden The account does not have the correct privileges
- `404` — Not found. No shadow exists for the requested trackingId.

---

[API](https://skmtc.net/here/apis/tracking.md) · [All operations](https://skmtc.net/here/apis/tracking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/here/tracking/versions/efa162f7023c/schema)