---
title: "Bulk Delete DLQ messages"
method: DELETE
path: "/v2/dlq"
tags: ["DLQ"]
---

# Bulk Delete DLQ messages

`DELETE /v2/dlq`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/dlq`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/qstash-rest-api/docs/v2/dlq/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete multiple messages from the DLQ

## Query parameters

- `dlqIds` string[]
- `cursor` string
- `messageId` string
- `url` string[]
- `topicName` string[]
- `scheduleId` string[]
- `queueName` string[]
- `fromDate` integer
- `toDate` integer
- `responseStatus` integer[]
- `callerIp` string[]
- `label` string[]
- `flowControlKey` string[]
- `count` integer

## Response `200`

DLQ messages deleted successfully

- object
  - `cursor` string: A cursor which you can use in subsequent requests to paginate through all messages. If no cursor is returned, you have reached the end of the messages.
  - `deleted` integer: The number of messages that were deleted.

## Changes

- **2026-06-25** `9bff0f72df49`: 7 info
  - for the `query` request parameter `callerIp`, the type was generalized from `string` to `array`
  - for the `query` request parameter `flowControlKey`, the type was generalized from `string` to `array`
  - for the `query` request parameter `queueName`, the type was generalized from `string` to `array`
  - for the `query` request parameter `responseStatus`, the type was generalized from `integer` to `array`
  - …3 more
- **2026-06-09** `d30bd0904328`: 1 info
  - for the `query` request parameter `label`, the type was generalized from `string` to `array`
- **2026-06-09** `d859c277ced2`: 1 info
  - for the `query` request parameter `label`, the type was generalized from `array` to `string`
- **2026-05-15** `75ecd1c6fb73`: 1 info
  - for the `query` request parameter `label`, the type was generalized from `string` to `array`
- **2025-12-09** `c11f4b380d03`: 1 info
  - added the new optional `query` request parameter `flowControlKey`

[Operation history](https://skmtc.dev/upstash/apis/qstash-rest-api/changes/v2/dlq/delete.md)

---

[API](https://skmtc.dev/upstash/apis/qstash-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/qstash-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/qstash-rest-api/revisions/0c3b83ef4770?raw)