Workflows
Approvals
Drop an Approval node anywhere a human needs to confirm. The workflow pauses, a reviewer approves or rejects, execution resumes on the chosen branch.
What you'll learn
- How approvals pause and resume a workflow
- How to set the approver role and escalation
- How the approval queue and timeout work
Configure an Approval node
- 1
Set the approver role
Pick a workspace role (Admin, Reviewer, custom). Anyone holding that role can act on the pending approval. For a specific person, use a custom role with one member. - 2
Write the request prompt
The text the reviewer sees. Reference workflow data inline — for example, "Approve refund of trigger.amount for trigger.customer?". Keep it scannable; reviewers act on dozens a day. - 3
Set the timeout
How long the approval stays pending. After timeout, the workflow auto-routes to a configurable outcome — usually the reject branch. - 4
Configure escalation
Optionally escalate to a second role after a fraction of the timeout has elapsed. Useful when the primary approver is unavailable.
How the queue behaves
Pending approvals appear in the reviewer's Approvals inbox. Each entry shows the workflow name, the request prompt, the rendered context, and Approve / Reject buttons. The workflow run sits in a paused state — counts toward concurrent runs but consumes no LLM tokens — until the reviewer acts or the timeout fires.
After the decision
Approve routes execution to the approved branch; Reject routes to the rejected branch; Timeout routes to whichever branch you configured as the timeout outcome. The reviewer's identity, decision, and any comment are recorded in the run trace.
Frequently asked questions
- Can approvers leave a comment?
- Yes. The Approve and Reject actions both accept an optional comment that is recorded in the trace and passed downstream to subsequent nodes.
- What if no one in the approver role is online?
- The approval stays pending until the timeout fires. Configure escalation to a secondary role to avoid stuck workflows. Notifications go to email and Slack if either is connected.
- Can I approve via Slack or email instead of the dashboard?
- Yes. Connect the Slack or Email channel to your workspace and Approve/Reject buttons show up directly in the notification. The action is recorded the same way as a dashboard approval.