Bulk Delete DLQ messages

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

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

DELETE

dlq

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

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

Authorizations

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 the label of the message assigned by the user

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.

List DLQ messages Get a DLQ message

⌘I