---
title: "POST /tracking/v0/trackers/{TrackerName}/delete-positions"
method: POST
path: "/tracking/v0/trackers/{TrackerName}/delete-positions"
---

# POST /tracking/v0/trackers/{TrackerName}/delete-positions

`POST /tracking/v0/trackers/{TrackerName}/delete-positions`

Deletes the position history of one or more devices from a tracker resource.

## Path parameters

- `TrackerName` string, required

## Request body

- object
  - `DeviceIds` Id[], required — <p>Devices whose position history you want to delete.</p> <ul> <li> <p>For example, for two devices: <code>“DeviceIds” : [DeviceId1,DeviceId2]</code> </p> </li> </ul>

## Response `200`

Success

- BatchDeleteDevicePositionHistoryResponse
  - `Errors` BatchDeleteDevicePositionHistoryError[], required — Contains error details for each device history that failed to delete.
    - `DeviceId` string, required — The ID of the device for this position.
    - `Error` BatchItemError, required — Contains the batch request error details associated with the request.
      - `Code` 'AccessDeniedError' | 'ConflictError' | 'InternalServerError' | 'ResourceNotFoundError' | 'ThrottlingError' | 'ValidationError' — The error code associated with the batch request error.
      - `Message` string — A message with the reason for the batch request error.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ValidationException
- `484` — ThrottlingException

---

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