Approval Gate Node

The approval-gate node suspends execution and waits for a human decision. Use it to add human-in-the-loop checkpoints before high-stakes actions.

Configuration Fields

Field	Type	Description
`message`	string	Context message shown to the approver in the dashboard (supports `{{}}`)

How It Works

Execution reaches the approval-gate node

The workflow engine suspends the execution at this node. The execution status changes to suspended.

Approver is notified

The dashboard displays the suspended execution with the configured message and Approve / Reject buttons.

Human responds

Via the dashboard (Executions → [id] → Approve / Reject) or directly via:

PATCH /workspaces/:wId/pods/:podId/executions/:id/respond

with body:

{ "approved": true }

{ "approved": false, "reason": "Not authorized" }

Execution resumes or fails

Approved: workflow continues from where it was suspended
Rejected: execution is marked failed with the rejection reason

Output

On approval, lastOutput is unchanged — the approval gate is transparent to data flow.

Suspended executions timeout after 10 minutes of SSE stream inactivity. The execution remains in suspended state indefinitely until a response is submitted — there is no automatic timeout on the suspension itself.

Example Config

{
  "message": "About to send email to {{input.recipientEmail}}. Approve to proceed."
}

Approval Gate Node

On this page