> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retry a run

> Resume a failed run from the step that failed last.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#plan-access).

Resume a failed run from the step that failed last. Steps that finished before it do not run again, and the run keeps its `id`. It answers `200` with the run's `id`, `workflowId` and `status`, which is `running`.

The failed step runs again. So a step that may already have sent its message or call can't be retried. That is a step that timed out, failed after it started sending, or placed a call that got no answer back.

A webhook your endpoint refused can be retried. That is a `4xx` error other than `408` or `429`, or a redirect we could not follow. It will be sent again. A webhook that got a `5xx`, `408` or `429` answer, or no answer in time, can't be retried.

These runs get `409`:

* A run that is not failed: cancelled, still going, already being retried, or completed.
* A run with no failed step to resume from.
* A run where steps ran after its failed step.
* A run our system stopped because it stalled.
* A run whose failed step may already have sent its message or call.
* A run whose contact has restricted processing.

## Path Parameters

**id** `string` *required*

The workflow's id.

**runId** `string` *required*

The run's id.

```bash cURL theme={null}
curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000/retry" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json Response theme={null}
{
  "id": "623e4567-e89b-12d3-a456-426614174000",
  "workflowId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "running"
}
```

## Errors

| Status | When |
| - | - |
| `400` | The workflow id or run id is not a valid UUID, or the retry would run a step that turns DND off. |
| `402` | The account has no plan, or its subscription is not active. |
| `403` | Your plan is not VIP, workflows are not on your plan, or the workspace is locked. |
| `404` | No workflow or run has this id, or it is not in this key's scope. |
| `409` | The run can't be retried in its current state, its failed step may already have sent its message or call, or its contact has restricted processing. |
| `502` | We could not check the workspace or plan status. Try again. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.