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

# Workflows Overview

> Graph-based durable workflows. Orchestrate multi-step processes with agents, approvals, and webhooks.

Workflows execute complex multi-step processes. Each node represents an action (HTTP call, agent run, human approval, etc.).

## What is a Workflow?

A workflow is a directed graph of nodes:

* **Start** - Trigger
* **Nodes** - Actions (HTTP, agent, approval, etc.)
* **Edges** - Connections between nodes
* **End** - Result

Supports:

* Conditional logic
* Parallel execution
* Error handling
* Human approval loops

## Node Types

<CardGroup cols={2}>
  <Card title="Start">
    Trigger point. Webhook, schedule, or manual.
  </Card>

  <Card title="Agent">
    Run an agent with input.
  </Card>

  <Card title="HTTP">
    Call external API.
  </Card>

  <Card title="Approval">
    Human review and decision.
  </Card>

  <Card title="Webhook">
    Receive data from external service.
  </Card>

  <Card title="Pause">
    Wait for manual resumption.
  </Card>

  <Card title="Data Transform">
    Transform/map data.
  </Card>

  <Card title="End">
    Complete workflow.
  </Card>
</CardGroup>

## Workflow States

| State       | Meaning                    |
| ----------- | -------------------------- |
| **Running** | Currently executing        |
| **Success** | Completed successfully     |
| **Failed**  | Error occurred             |
| **Waiting** | Awaiting approval or input |
| **Paused**  | Manually paused            |

## Creating a Workflow

1. **Workflows** > **Create Workflow**
2. Name your workflow
3. Open designer
4. Drag nodes onto canvas
5. Connect nodes with edges
6. Configure each node
7. Deploy

## Example: Content Approval Workflow

```mermaid theme={null}
graph TD
    A["Start<br/>new content submission"]
    B["Agent<br/>Analyze content"]
    C["Approval<br/>Manager review"]
    D["HTTP<br/>Publish"]
    E["Agent<br/>Notify creator"]
    F["End<br/>Complete"]

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

## Running Workflows

**Manually:**

1. **Workflows** > Select workflow
2. Click **Run**
3. Provide input (if required)
4. Wait for completion

**Via Webhook:**
POST to workflow's trigger endpoint with data.

**Via Schedule:**
Set cron expression to trigger automatically.

## Monitoring

Track workflow executions:

1. **Workflows** > Select workflow
2. **Runs** tab
3. See all executions
4. Click to view details
5. See each node's status

## Error Handling

Workflows auto-retry on error:

* Default: 3 attempts
* Configurable per node
* Falls through to End node on failure

## Cost

For current pricing details, see [Pricing](https://noorle.com/pricing/).

## Limits

| Limit                 | Value          |
| --------------------- | -------------- |
| Workflows per account | 500            |
| Nodes per workflow    | 100            |
| Execution time        | 1 hour max     |
| Running workflows     | 100 concurrent |
| Retention             | 90 days (logs) |

## Next Steps

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