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

# Workflow State Machine

> Workflow execution states (Running, Success, Failed, Waiting, Paused, Suspended, Canceled), transition rules, and how to retry, extend, or cancel runs

Workflows transition through states during execution.

## States

| State         | Meaning              | Next                   |
| ------------- | -------------------- | ---------------------- |
| **Running**   | Executing            | Success/Failed/Waiting |
| **Success**   | Completed            | (End)                  |
| **Failed**    | Error                | (End)                  |
| **Waiting**   | Approval pending     | Running/Failed         |
| **Paused**    | Manual pause         | Running                |
| **Suspended** | Resource unavailable | Waiting                |
| **Canceled**  | Manually canceled    | (End)                  |

## Transitions

```mermaid theme={null}
graph TD
    A["Start"]
    B["Running"]
    C["Success"]
    D["Failed<br/>or retry"]
    E["Waiting<br/>approval"]
    F["Paused<br/>resume"]
    G["End"]

    A --> B
    B -->|Success| C
    B -->|Failed| D
    B -->|Waiting| E
    B -->|Paused| F
    C --> G
    D --> G
    E -->|approval| B
    F -->|resume| B
```

## Viewing State

1. **Workflows** > Select workflow
2. **Runs** tab
3. Click execution
4. See current state
5. View history

## Extending Timeout

If workflow in **Waiting** state for approval:

1. Click **Extend Timeout**
2. Set new deadline
3. Continues waiting

## Retrying Failed

If workflow fails:

1. Click **Retry**
2. Runs from failure point
3. Re-executes last node
4. Continues forward

## Pausing Workflow

Manually pause:

1. Click **Pause**
2. Workflow halts
3. Click **Resume** to continue

## Canceling Workflow

Cancel running workflow:

1. Click **Cancel**
2. Immediately stops
3. Cannot resume
4. Marked as canceled

## Next Steps

* [Node Types](/docs/run/workflows/node-types)
* [Human Approval](/docs/run/workflows/human-in-the-loop)
* [Webhooks](/docs/run/workflows/webhooks)