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

# Introduction

> Understand human-in-the-loop review tasks in Ingestly pipelines.

A **review task** is created when a pipeline's review action node fires, pausing the run and requesting human review of the extracted data before continuing.

## When reviews are triggered

Review tasks are created based on the **trigger mode** configured on the review action node:

| Trigger mode       | Behavior                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------- |
| **Always**         | Every run that reaches the review node creates a review task                                      |
| **Low confidence** | A review task is created only when the AI extraction confidence is below the configured threshold |

## Review task lifecycle

```mermaid actions={false} theme={null}
%%{init: {'flowchart': {'defaultRenderer': 'elk', 'curve': 'linear'}}}%%
flowchart LR
    Start(( )) --> Pending
    Pending --> InReview
    InReview --> ApprovedPending[Approved - Pending Resume]
    InReview --> RejectedPending[Rejected - Pending Resume]
    ApprovedPending --> Approved
    RejectedPending --> Rejected
    ApprovedPending --> ResumeFailed[Resume Failed]
    RejectedPending --> ResumeFailed
    InReview --> Cancelled
```

| Status                        | Description                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Pending**                   | Task is waiting in the review queue for someone to claim it                                                              |
| **In review**                 | A reviewer has claimed the task and is reviewing the data                                                                |
| **Approved - Pending Resume** | Reviewer approved the data, waiting for the pipeline to resume                                                           |
| **Rejected - Pending Resume** | Reviewer rejected the data, waiting for the pipeline to process the rejection                                            |
| **Approved**                  | Review complete. The run resumed with the approved data                                                                  |
| **Rejected**                  | Review complete. The run was marked as failed                                                                            |
| **Resume Failed**             | The reviewer's decision could not be applied because the pipeline run was marked failed (the workflow was unrecoverable) |
| **Cancelled**                 | The run was cancelled while this task was still awaiting review, so the task was closed without a decision               |

<Note>The "Pending Resume" statuses are brief transitional states. You may see them in the UI between the reviewer's decision and the pipeline resuming.</Note>

## Review workflow

1. A run reaches a review action node and creates a review task
2. The run pauses with status **Review**
3. A reviewer claims the task from the review queue
4. The reviewer inspects the extracted data, makes corrections if needed
5. The reviewer either **approves** (run resumes) or **rejects** (run fails)

## Claiming tasks

Only one reviewer can work on a task at a time. When you claim a task, it is locked to you. If you need to release it, you can unclaim the task to return it to the queue.

## Approving and rejecting

When approving a task, you can edit the extracted data before submitting. The corrected data is passed to the next step in the pipeline.

When rejecting a task, you can add notes explaining why the data was rejected. The run is marked as failed.

## Managing reviews

You manage review tasks from the [Reviews page](/reviews/queue). The review queue shows all pending and in-progress tasks across your organization.

<CardGroup cols={2}>
  <Card title="Human review guide" icon="user-check" href="/guides/human-review">
    Step-by-step guide to setting up human review in your pipeline
  </Card>

  <Card title="Reviews page" icon="browser" href="/reviews/queue">
    Learn how to use the review queue
  </Card>
</CardGroup>