Bulk Delete DLQ messages

Delete multiple messages from the DLQ

DELETE /v2/dlq

Bulk Delete DLQ messages

cURL

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

200

{
  "cursor": "<string>",
  "deleted": 123
}

Authorizations

bearerAuthbearerAuthQuery

Authorization · string · header · required

QStash authentication token

Query Parameters

dlqIds · string[]

List of DLQ IDs to delete. If provided, other filters are ignored.

cursor · string

By providing a cursor you can paginate through all of the messages in the DLQ

messageId · string

Filter DLQ messages by message ID

url · string

Filter DLQ messages by destination URL

topicName · string

Filter DLQ messages by URL Group name

scheduleId · string

Filter DLQ messages by schedule ID

queueName · string

Filter DLQ messages by queue name

fromDate · integer<int64>

Filter DLQ messages by starting date, in milliseconds (Unix timestamp). This is inclusive.

toDate · integer<int64>

Filter DLQ messages by ending date, in milliseconds (Unix timestamp). This is inclusive.

responseStatus · integer

Filter DLQ messages by HTTP response status code of the last delivery attempt

callerIp · string

Filter DLQ messages by IP address of the publisher

label · string[]

Filter DLQ messages by label. Supports multi-value filtering. 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

flowControlKey · string

Filter DLQ messages by Flow Control Key

count · integer · default: 100

The number of messages to delete.

Required range: x <= 100

Response

200 - application/json

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.