Retry Failure Callback

curl --request POST \
  --url https://qstash.upstash.io/v2/workflows/dlq/callback/{dlqId} \
  --header 'Authorization: Bearer <token>'

{
  "workflowRunId": "<string>",
  "workflowCreatedAt": 123
}

DLQ

Retry Failure Callback

If the failure callback for a workflow run has failed, you can use this endpoint to manually trigger the failure callback again. This is useful for ensuring that your system is notified of workflow failures even if the original callback attempt did not succeed.

The state of the failure callback for each workflow run is included in the DLQ message response as failureCallbackInfo.state. You can filter for all workflow runs with a failed failure callback by using the failureCallbackState filter when listing workflow runs in the DLQ with the /v2/workflows/dlq endpoint.

POST

workflows

dlq

callback

{dlqId}

Retry Failure Callback

curl --request POST \
  --url https://qstash.upstash.io/v2/workflows/dlq/callback/{dlqId} \
  --header 'Authorization: Bearer <token>'

{
  "workflowRunId": "<string>",
  "workflowCreatedAt": 123
}

Authorizations

Authorization

string

header

required

QStash authentication token

Path Parameters

dlqId

string

required

The DLQ ID of the failed workflow run whose failure callback should be retried.

Response

Failure callback retried successfully

workflowRunId

string

The ID of the workflow run.

workflowCreatedAt

integer<int64>

The timestamp when the workflow run was created (Unix timestamp in milliseconds).

Bulk Restart Workflows from DLQ Cancel In-Progress Failure Callback

⌘I