Bulk Delete Failed Workflow Runs
Delete multiple failed workflow runs from the DLQ.
curl --request DELETE \
--url https://qstash-{region}.upstash.io/v2/workflows/dlq \
--header 'Authorization: Bearer <token>'{
"deleted": 123,
"cursor": "<string>"
}Authorization
Bearer authentication header of the form Bearer <token>.
Query parameters
List of specific DLQ IDs to delete. If provided, other filters are ignored.
Pagination cursor for deleting in batches.
Maximum number of workflows to delete per request.
Filter by starting date in milliseconds (Unix timestamp). This is inclusive.
Filter by ending date in milliseconds (Unix timestamp). This is inclusive.
Filter by workflow URL. Supports multiple values.
Filter by workflow run ID.
Filter by workflow creation timestamp in milliseconds (Unix timestamp).
Filter by label assigned to the workflow run. Supports multiple values. You can pass multiple values to match workflow runs with any of the given labels (OR logic).
Examples:
label=my_labellabel=label_1&label=label_2label=label_1,label_2
Filter by failure function state. Supports multiple values.
| State | Description |
|---|---|
| CALLBACK_INPROGRESS | The failure function is in progress. |
| CALLBACK_SUCCESS | The failure function run successfully. |
| CALLBACK_FAIL | The failure function failed to run. |
| CALLBACK_CANCELED | The failure function was manually canceled |
Filter by IP address of the publisher. Supports multiple values.
Filter by Flow Control Key. Supports multiple values.
Response
200 — Workflows deleted successfully
The number of workflow runs that were deleted.
Pagination cursor for the next batch. Only present when using filters without DLQ IDs.
400 — Bad Request
Error message
401 — Unauthorized
Error message
500 — Internal Server Error
Error message