Skip to main content
DELETE
/
v2
/
workflows
/
dlq
/
{dlqId}
curl -X DELETE https://qstash.upstash.io/v2/workflows/dlq/my-dlq-id \
  -H "Authorization: Bearer <token>"

Documentation Index

Fetch the complete documentation index at: https://upstash-cloud-4245.mintlify.app/llms.txt

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

Delete a failed workflow run from the Dead Letter Queue (DLQ). When a workflow run fails, it is moved to the DLQ. You can manually remove a failed workflow run from the DLQ using this endpoint. This is useful for cleaning up failed runs that you no longer wish to retry or analyze.

​
Request

​
dlqId
string
The DLQ id of the failed workflow run you want to remove. You will see this id when listing all workflow runs in the DLQ with the /v2/workflows/dlq endpoint.

​
Response

The endpoint doesn’t return a response body. A status code of 200 means the workflow run was removed from the DLQ. If the workflow run is not found in the DLQ (either it has already been removed by you, or automatically), the endpoint returns a 404 status code. 
curl -X DELETE https://qstash.upstash.io/v2/workflows/dlq/my-dlq-id \
  -H "Authorization: Bearer <token>"