---
title: "Purge the dead letter queue"
method: POST
path: "/api/admin/queues/deadletter/purge"
tags: ["Dead Letter Queue"]
---

# Purge the dead letter queue

`POST /api/admin/queues/deadletter/purge`

Permanently removes all messages from the dead letter queue. This is a destructive operation. This endpoint is feature-gated and only available when AdminEndpointsEnabled is true.

## Response `200`

OK - Purge result

- PurgeResult
  - `purged` boolean
  - `approximateMessagesPurged` integer
  - `purgedAt` string, date-time

## Other responses

- `400` — Bad Request - DLQ URL not configured
- `429` — Too Many Requests - A purge operation is already in progress
- `503` — Service Unavailable - Unable to reach the dead letter queue

---

[API](https://skmtc.dev/defra/apis/livestock-keeper-data-api-internal.md) · [All operations](https://skmtc.dev/defra/apis/livestock-keeper-data-api-internal/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/defra/livestock-keeper-data-api-internal/revisions/bfd8eb077a9b/schema)