> ## 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.

# Human-in-the-Loop Workflows

> Add human decision points to workflows with approval nodes.

Approval nodes pause workflows for human review and decision.

## How Approval Works

1. Workflow reaches approval node
2. Notification sent to approver
3. Approver reviews content
4. Approver decides: Approve/Reject/More Info
5. Workflow continues based on decision

## Approval Node Configuration

<Steps>
  <Step title="Add Approval Node">
    1. Open workflow designer
    2. Drag Approval node
    3. Connect to workflow
  </Step>

  <Step title="Configure">
    * **Title**: "Manager Review"
    * **Approvers**: Select users/roles
    * **Options**: Approve, Reject, Request More Info
    * **Timeout**: 24 hours
  </Step>

  <Step title="Route Decisions">
    * Approve → next node
    * Reject → alternate path
    * Request Info → pause and wait
  </Step>
</Steps>

## Approver Notifications

Notification sent to approvers via:

* Email
* Slack
* In-Console notification

Includes:

* Content to review
* Context
* Deadline

## Routing by Decision

Each approval option can route to different nodes:

```mermaid theme={null}
graph TD
    A["Approval"]
    B["Publish"]
    C["Notify Creator"]
    D["Pause"]

    A -->|Approve| B
    A -->|Reject| C
    A -->|Request Info| D
```

## Timeout Handling

Approval timeout configuration:

* **24 hours** (default)
* **Auto-reject** if no response
* **Escalate** to manager if no response

Prevents workflows hanging indefinitely.

## Example: Content Review

```mermaid theme={null}
graph TD
    A["Start<br/>New article submitted"]
    B["Agent<br/>Analyze content"]
    C["Approval<br/>Editor review 24hr timeout"]
    D["Publish"]
    E["Archive"]
    F["Notify Author"]
    G["End"]

    A --> B
    B --> C
    C -->|Approve| D
    C -->|Reject| E
    C -->|Request Changes| F
    D --> G
    E --> G
    F --> G
```

## Audit Trail

Track all approvals:

1. **Runs** tab
2. Click execution
3. See who approved
4. When approved
5. Comments

## Multiple Approvers

Require multiple approvals:

1. Add multiple approval nodes in sequence
2. Each must approve before proceeding
3. Can be parallel (set up edges)

## Next Steps

* [Workflows Overview](/docs/run/workflows/overview)
* [Node Types](/docs/run/workflows/node-types)
* [Webhooks](/docs/run/workflows/webhooks)