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

# Human in the loop

> Pause workflow runs for approval or user input, then resume with the API.

Some automations must **stop and wait** for a person — approve a risky action, confirm a payload, or supply missing input. In Flowra this is **human in the loop (HITL)**.

## When it appears

* A **static workflow** graph includes a **`human_wait`** (or equivalent approval) node.
* An agent run **interrupts** and waits for a resume command (for example after a tool that requires confirmation).

While paused, inspect the [execution](/guides/workflows) or [thread](/guides/threads) state, then **resume** with the required input.

## Resume a paused workflow execution

After `POST /api/v1/workflow/manager/execute/{id}` returns a **thread ID**, if the run pauses:

**POST** `/api/v1/workflow/manager/executions/thread/{threadId}/resume`

Send any required input in the body (see **resume** schemas in the [API reference](/api-reference)). Use this for static workflow runs that wait for user input or approval.

```bash theme={null}
curl -X POST "https://flowra.dev/api/v1/workflow/manager/executions/thread/YOUR_THREAD_ID/resume" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "resumeValue": { "approved": true } }'
```

## Resume in the Chat / Threads API

For Graphify-style agent runs, join or continue the stream and send a **command** such as `{ "resume": { "decisions": [...] } }` when the run is interrupted. See [Threads](/guides/threads) and Chat run schemas in the [API reference](/api-reference) (`command.resume` on run input).

## Product tips

* In the dashboard, open the execution detail to see where the run stopped.
* Disable [triggers](/guides/triggers) while you change approval steps if concurrent fires are a risk.
* Keep public [widgets](/product/widgets-and-embeds) on workflows that do not expose unchecked high-impact tools without approval.

## Related

* [Workflows and agents](/guides/workflows-and-agents)
* [Workflows](/guides/workflows)
* [Threads](/guides/threads)
* [Native tools: Workflow](/guides/native-tools/workflow) — `human_wait` nodes on static graphs