Human Approvals

A human approval is a durable wait, not a busy worker. The instance persists its state, releases compute, and resumes only after an authorized signal supplies one of the declared choices.

1. Define the review step

1{
2  "id": "review",
3  "type": "step",
4  "handler": "human_review",
5  "wait_for_input": {
6    "prompt": "Approve this release?",
7    "choices": [
8      { "label": "Approve", "value": "approve" },
9      { "label": "Reject", "value": "reject" }
10    ],
11    "store_as": "review_decision"
12  }
13}

2. Observe the waiting state

Read the instance and confirm the current step is review and the state is waiting. Show the prompt, choices, sequence name, requester, and creation time to the reviewer.

3. Resume with a signal

1curl -X POST "$ORCH8_URL/api/v1/instances/$INSTANCE_ID/signals"   -H "x-api-key: $ORCH8_API_KEY"   -H "content-type: application/json"   -d '{"name":"human_input:review","payload":{"value":"approve"}}'

Authorization and audit

Authorize the reviewer before sending the signal, record who decided and when, reject undeclared values, and make duplicate submissions idempotent. A rejected choice should follow an explicit workflow branch rather than silently canceling the instance.