Skip to main content
POST
/
v2
/
dlq
/
retry
/
{dlqId}
Retry a DLQ message
curl --request POST \
  --url https://qstash-{region}.upstash.io/v2/dlq/retry/{dlqId} \
  --header 'Authorization: Bearer <token>'
{
  "messageId": "<string>",
  "deduplicated": true
}

Documentation Index

Fetch the complete documentation index at: https://upstash.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

When a DLQ message is retried, a new message with the same body and headers is created and scheduled for delivery. The original DLQ message is then removed from the DLQ.
You can pass all configuration headers to override the configuration of the original message.For example, if the retry count of the original message is 5, you can set it to 0 for the retried message by passing Upstash-Retries: 0 header to this request. Check out publish documentation for complete list of configuration options you can pass.

Authorizations

​
Authorization
string
header
required

QStash authentication token

Path Parameters

​
dlqId
string
required

The DLQ ID of the message you want to retry.

Response

Message retry initiated successfully

​
messageId
string

Unique identifier for the published message or the old message ID if deduplicated

​
deduplicated
boolean

Whether this message is a duplicate and was not sent to the destination.