Retry a Step Now

Execute a workflow step that is waiting for its next retry immediately

1 min read

post/v2/messages/{messageId}/retry

Request example

curl --request POST \
  --url https://qstash-eu-central-1.upstash.io/v2/messages/{messageId}/retry \
  --header 'Authorization: Bearer <token>'

Response

{
  "error": "<string>"
}

post/v2/messages/{messageId}/retry

When a step fails, Upstash Workflow schedules the next attempt according to the configured retry delay. This endpoint skips the remaining wait and executes the step right away, so the workflow run can continue without waiting.

Retrying now does not add an extra attempt. It moves the already scheduled retry forward, so the retry count and the remaining retries stay the same.

The messageId of a retrying step is available in the step details returned by the logs endpoint. Steps waiting for a retry have a nextDeliveryTime. If multiple parallel steps are waiting for a retry, call this endpoint once for each step.

See Retry a Step Now for more details.

Authorization

Authorizationstringheaderrequired#

QStash authentication token

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

Path parameters

messageIdstringrequired#

The message ID of the retrying step.

Responses

The step is scheduled for immediate execution.

Bulk Cancel Workflow Runs List Bulk Actions