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

# Status and recovery

> Pipeline states, rerun, clone, and blocked runs

## Run statuses

Workflow runs use the same state machine as pipelines:

| Status                   | Meaning                              |
| ------------------------ | ------------------------------------ |
| `draft`                  | Definition not yet activated         |
| `active`                 | Run in progress                      |
| `done`                   | All steps finished successfully      |
| `blocked`                | Waiting on agent or external failure |
| `failed`                 | Terminal failure                     |
| `cancelled` / `archived` | Stopped or hidden from active lists  |

The app loads **allowed actions** from `/pipelines/status-machine` (e.g. Start, Resume, Cancel, Rerun, Archive).

## Recovery actions

| Action             | Requires Bridge | Notes                                            |
| ------------------ | --------------- | ------------------------------------------------ |
| **Resume**         | Yes             | Continue from blocked/failed where policy allows |
| **Rerun**          | Yes             | New attempt; hidden when Bridge offline          |
| **Clone to draft** | Yes             | Copy definition for editing a new version        |
| **Cancel**         | —               | Stop in-flight work                              |

<Warning>
  **Clone** and **Rerun** need a live Bridge connection — the API returns **503** if no agent runtime is connected.
</Warning>

## Blocked runs

When a step task is **blocked**, fix agent credentials or instructions on the task detail page, then **Retry** or move to backlog per task rules. Pipeline-level **Resume** may be available depending on status.

## Definitions with zero nodes

You can save an empty workflow definition (zero nodes) as a draft placeholder — useful while designing, but activation requires at least one valid step.