Get a DLQ message
Get a specific message from the DLQ
curl --request GET \
--url https://qstash-{region}.upstash.io/v2/dlq/{dlqId} \
--header 'Authorization: Bearer <token>'{
"messageId": "<string>",
"url": "<string>",
"topicName": "<string>",
"endpointName": "<string>",
"method": "<string>",
"header": "<string>",
"body": "<string>",
"bodyBase64": "<string>",
"maxRetries": 123,
"notBefore": 123,
"createdAt": 123,
"callback": "<string>",
"failureCallback": "<string>",
"queueName": "<string>",
"scheduleId": "<string>",
"callerIP": "<string>",
"label": "<string>",
"labels": [
"<string>"
],
"flowControlKey": "<string>",
"rate": 123,
"period": 123,
"parallelism": 123,
"responseStatus": 123,
"responseHeader": "<string>",
"responseBody": "<string>",
"responseBodyBase64": "<string>"
}Authorization
Bearer authentication header of the form Bearer <token>.
Path parameters
The DLQ ID of the message you want to retrieve.
Response
200 — DLQ message details
Unique identifier for the message
The URL to which the message should be delivered.
The URL Group (a.k.a. topic) name if this message was sent to a URL Group.
The endpoint name of the message if the endpoint is given a name within the URL group.
The HTTP method to use for the message.
The HTTP headers sent to your API.
The body of the message if it is composed of utf8 chars only, empty otherwise.
The base64 encoded body if the body contains a non-utf8 char only, empty otherwise.
The number of retries that should be attempted in case of delivery failure.
The unix timestamp in milliseconds before which the message should not be delivered.
The unix timestamp in milliseconds when the message was created.
The url where we send a callback each time the message is attempted to be delivered.
The url where we send a callback to after the message is failed
The name of the queue if the message is enqueued to a queue.
The scheduleId of the message if the message is triggered by a schedule
IP address of the publisher of this message.
The label of the message assigned by the user. Deprecated in favor of labels.
The list of labels assigned to the message by the user.
The flow control key used for rate limiting.
The rate value used for flow control.
The period value used for flow control.
The parallelism value used for flow control.
The HTTP status code received from the destination API.
The HTTP response headers received from the destination API.
The body of the response if it is composed of utf8 chars only, empty otherwise.
The base64 encoded body of the response if the body contains a non-utf8 char only, empty otherwise.
404 — If the message is not found in the DLQ, (either is has been removed by you, or automatically), the endpoint returns a 404 status code.
Error message