DLQ

Restart Workflow from DLQ

Restart a failed workflow run from the DLQ. The workflow will start from the beginning.

Unlike resume, which continues from where the workflow failed, restart executes the entire workflow from the first step. A new workflow run ID is generated and all steps will be executed again.

post/v2/workflows/dlq/restart/{dlqId}

Request

Base URL
https://qstash-eu-central-1.upstash.io
Auth
- HTTP bearer
- or API key in query parameter qstash_token
TypeScript
https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/docs/v2/workflows/dlq/restart/:dlqId/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

dlqIdstring required

The DLQ ID of the workflow run to restart.

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> (e.g., "10s", "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 label(s) for the workflow.

You can assign multiple labels by providing a comma-separated list.

Example: label_1,label_2

Upstash-Failure-Callbackstring

Override the failure callback URL for the workflow.

Response

Workflow restarted successfully

workflowRunIdstring

The ID of the restarted workflow run (a new ID is generated for the restarted run).

workflowCreatedAtinteger

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

Changes

No recorded changes to this operation across all 12 revisions of this API.