What Are Review Tasks?
Review tasks are created when a workflow’s human intervention node is triggered. They represent a trace that needs human approval before it can be completed. Not every trace creates a review task. Review tasks only exist when your workflow determines that human oversight is needed.When Review Tasks Are Created
Review Task Components
Linked Trace
Every review task is linked to the trace that triggered it. The trace contains:- Function Name - What action was attempted
- Arguments - Input data for the action
- Metadata - Additional context
- Session ID - Related traces in the same session
- Assessments - Policy evaluation results
Approval Requirements
Based on the human intervention node configuration:- Number of Approvals Needed - How many people must approve
- Timeout - How long to wait before escalation
- Channels - Where notifications are sent
Decisions
As reviewers respond:- Decision Type - Approved, Declined, or Change Requested
- Reviewer - Who made the decision
- Channel - Where the decision was made
- Reason - Optional explanation
- Timestamp - When the decision was made
Review Task States
| State | Description |
|---|---|
| Pending | Waiting for human decision |
| Processing | Being reviewed |
| Approved | Required approvals received |
| Rejected | Reviewer declined |
| Change Requested | Reviewer wants modifications |
| Requires Intervention | Needs additional review |
Viewing Review Tasks
In the dashboard:- Go to Review Tasks to see all tasks
- Filter by status, project, or date
- Click a task to see:
- The linked trace with full details
- Policy assessments
- Workflow execution history
- Decisions made so far
Making Decisions
Reviewers can respond through connected channels:| Channel | How |
|---|---|
| Slack | Click buttons or use reactions |
| Reply with APPROVE, DECLINE, or CHANGES | |
| Teams | Click adaptive card buttons |
| Web Dashboard | Use the decision panel |
| SMS | Reply with A, D, or C |
Multi-Approver Tasks
When multiple approvals are needed:- Each approver makes an independent decision
- One decline rejects the entire task
- All required approvals must be received
- Progress is shown in the dashboard
What Happens After Decision
| Decision | Result |
|---|---|
| Approved | Workflow continues through Approved path. Trace marked Completed. |
| Declined | Workflow continues through Declined path. Usually leads to rejection. |
| Change Requested | Workflow continues through Change path. Feedback sent to caller. |