Retry a Message Now

Deliver a message 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 delivery fails, QStash schedules the next attempt according to the message's retry delay. This endpoint skips the remaining wait and delivers the message right away.

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.

You can find messages waiting for a retry by listing the logs with state=RETRY.

See Retry a Message Now for more details.

Note

Messages published to a queue can not be rescheduled to retry now. The request returns 400 for them.

Authorization

Authorizationstringheaderrequired#

QStash authentication token

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

Path parameters

messageIdstringrequired#

The identifier of the message to retry.

Responses

The message is rescheduled for immediate delivery.

Cancel a Message Bulk Cancel Messages