Skip to main content
post/v2/workflows/dlq/bulkRestart
Request example
Response
post/v2/workflows/dlq/bulkRestart

Each restarted run begins at its first step.

The request returns after creating the action. Use its actionId with Get a Bulk Action to check progress.

Identical filters submitted while an action is already in-progress return the existing action.

Authorization

Authorizationstringheaderrequired#
QStash authentication token

1 alternative authorization method available — see the spec for details.

Query parameters

fromDateinteger#
Inclusive start of the DLQ date range, in Unix milliseconds.
toDateinteger#
Inclusive end of the DLQ date range, in Unix milliseconds.
workflowUrlstring[]#
Filter by workflow URL. Supports multiple values.
workflowRunIdstring#
Filter by workflow run ID.
workflowCreatedAtinteger#
Filter by workflow creation time, in Unix milliseconds.
labelstring[]#
Filter by workflow label. Supports multiple values.
failureFunctionStatestring[]#
Filter by failure function state. Supports multiple values.
callerIpstring[]#
Filter by publisher IP address. Supports multiple values.
flowControlKeystring[]#
Filter by flow control key. Supports multiple values.

Headers

Upstash-Retriesinteger#
Override the number of retries for the workflow steps.
Upstash-Delaystring#
Override the delay before executing the workflow. Format is <value><unit> (for example, 10s or 5m).
Upstash-Retry-Delaystring#
Override the retry delay expression for the workflow steps.
Upstash-Flow-Control-Keystring#
Override the flow control key for the workflow.
Upstash-Flow-Control-Valuestring#
Override the flow control configuration in the format parallelism=<value>, rate=<value>, period=<value>.
Upstash-Labelstring#
Override the workflow labels. Use a comma-separated list for multiple labels, such as label_1,label_2.
Upstash-Failure-Callbackstring#
Override the failure callback URL for the workflow.

Responses

application/json
The background action was created or an identical in-progress action was returned.
actionIdstringrequired#
ID used to check the background action's progress.
totalintegerrequired#
Number of failed workflow runs matching the filters when the action was created.