# Bulk Delete DLQ messages

> Delete multiple messages from the DLQ

## Endpoint

`DELETE https://qstash-{region}.upstash.io/v2/dlq`

## Parameters

- `dlqIds` (query, string[]): List of DLQ IDs to delete. If provided, other filters are ignored.
- `cursor` (query, string): By providing a cursor you can paginate through all of the messages in the DLQ
- `messageId` (query, string): Filter DLQ messages by message ID
- `url` (query, string[]): Filter DLQ messages by destination URL. Supports multiple values.
- `topicName` (query, string[]): Filter DLQ messages by URL Group name. Supports multiple values.
- `scheduleId` (query, string[]): Filter DLQ messages by schedule ID. Supports multiple values.
- `queueName` (query, string[]): Filter DLQ messages by queue name. Supports multiple values.
- `fromDate` (query, integer): Filter DLQ messages by starting date, in milliseconds (Unix timestamp). This is inclusive.
- `toDate` (query, integer): Filter DLQ messages by ending date, in milliseconds (Unix timestamp). This is inclusive.
- `responseStatus` (query, integer[]): Filter DLQ messages by HTTP response status code of the last delivery attempt. Supports multiple values.
- `callerIp` (query, string[]): Filter DLQ messages by IP address of the publisher. Supports multiple values.
- `label` (query, string[]): Filter DLQ messages by label. Supports multiple values. You can pass multiple values to match messages with any of the given labels (OR logic).

Examples:
- `label=my_label`
- `label=label_1&label=label_2`
- `label=label_1,label_2`

- `flowControlKey` (query, string[]): Filter DLQ messages by Flow Control Key. Supports multiple values.
- `count` (query, integer): The number of messages to delete.

## Responses

### 200 - DLQ messages deleted successfully

- `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.

## cURL

```bash
curl --request DELETE \
  --url https://qstash-{region}.upstash.io/v2/dlq \
  --header 'Authorization: Bearer <token>'
```