Approvals
Human-in-the-loop approval gates for process engine workflows. Processes pause at approval steps and wait for human decisions before continuing.
How It Works
A process execution reaches a human_approval step.
The step pauses the process (status: PAUSED).
An approval request appears in the Approvals inbox (accessible from the navigation bar).
The approver sees the process name, step description, context, and who requested it.
The approver can Approve or Reject, with an optional comment.
On approval, the process continues to the next step.
On rejection, the process execution is cancelled or follows the rejection path.
Approvals can have configurable timeouts.
Real-Time Notifications
An approval_required WebSocket event is fired when a process needs human approval. Approvals only apply to processes with human_approval step types defined in the process YAML.
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /api/approvals | GET | List pending approvals |
| /api/approvals/{id} | GET | Get approval details |
| /api/approvals/{id}/decide | POST | Submit decision (approve/reject) |