Retry Failure Callback

Retry a failed workflow failure callback from the DLQ.

When a workflow fails and has a failure callback configured, the callback is invoked. If the failure callback itself fails after all retries, it ends up in the DLQ. This endpoint allows you to retry that failed failure callback.

The callback must be in a failed state (not in-progress, not successful, not canceled). Once retried, the callback is republished and its state becomes in-progress.

POST /v2/workflows/dlq/callback/{dlqId}

Retry Failure Callback

cURL

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

200

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

Authorizations

bearerAuthbearerAuthQuery

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

200

application/json

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).