Skip to main content
The review node pauses a pipeline run and creates a human review task. A reviewer can inspect, edit, and approve the data before the pipeline continues. Use this node to add human-in-the-loop validation to your document processing workflows.

When to use review

  • You want a human gate before delivering results to a downstream system. Set Pause mode to Always.
  • You only want humans involved on uncertain runs. Pair LowConfidence with a confidence threshold, or Unverified Fields with extract’s Field confidence toggle.
  • You want a fallback path when validation fails on the Warn action: route the warned run into review for correction.
  • You want to gate the run on specific cross-field rules. Add an upstream Validation node and set this node’s pause mode to Validation failures. Only the runs whose rules recorded a failing field path pause.
  • You want to catch numeric disagreements between two sources. Add an upstream Reconcile node and set this node’s pause mode to Reconcile mismatch. Only the runs whose two sources disagree pause.
  • Skip review when an automated validation check or transform can fix the data deterministically. Reserve human time for cases that genuinely need judgment.

Configuration

Reminders nudge the assigned reviewer while the task is still pending. If the task is unassigned (anyone can claim), no per-person reminder is sent.

Inputs and outputs

Allowed inputs: Extract, validation, reconcile, HTTP, loop, variable, store, prompt. Maximum one input connection. Review pauses on extracted data, so it sits after the node that produced that data, not directly after filter pages or split. Output: Approved (and possibly edited) data, passed to the next connected node.

Common pitfalls

Always pauses every run. On a busy pipeline this floods the review queue and stalls throughput. Use LowConfidence or Unverified Fields to gate only the runs that need attention.
Unverified Fields mode only triggers when the upstream extract node has Field confidence enabled (Engine 1 only). Without it, no fields are ever marked unverified and the review node never pauses.
Validation failures activates whenever an upstream Validation node is present and consumes the failing field paths recorded by that node’s Warn action (when its rules can attribute them). The editor hides this pause mode when no Validation predecessor is connected.
Reconcile mismatch mode requires an upstream Reconcile node. The editor hides this pause mode when no Reconcile predecessor is connected.
The right threshold depends on what your runs actually score. Set Min confidence after you’ve seen real distributions for your documents; defaults that look reasonable can pause everything or nothing.
A reviewer can mark a run failed. Make sure the failure path is intentional: either delete the document, route to a fallback pipeline, or notify a system. Don’t let rejections sit silently.

Human review guide

Set up and manage human review workflows

Review queue

Learn how the review queue works

Extract action

Extract data before review

Transform action

Transform data after review

Reconcile action

Compare two sources before review