---
title: "Retry a Step Now"
method: POST
path: "/v2/messages/{messageId}/retry"
tags: ["Runs"]
---

# Retry a Step Now

`POST /v2/messages/{messageId}/retry`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/messages/{messageId}/retry`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/docs/v2/messages/:messageId/retry/post.ts> (a function with typed inputs; its response is checked against the schema)

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

## Path parameters

- `messageId` string, required

## Response `200`

The step is scheduled for immediate execution.

## Other responses

- `400`: The message id is invalid.
- `404`: Step not found, or the step is not waiting for a retry.
- `500`: Internal Server Error

## Changes

- **2026-09-22** `4c95aad18689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/changes/v2/messages/:messageId/retry/post.md)

---

[API](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/revisions/251bee05a7ec?raw)