Skip to main content

​
Approval wait-state

The Approval node pauses automation execution and waits for a human to approve or reject it. Each pending approval has a unique, one-time token. The automation sends this token to a reviewer (e.g. via email or Slack), and the reviewer responds via these endpoints.

​
Get approval status

GET /api/v1/automation/approvals/{token} Returns the current status of the approval and, if still pending, a prompt message.
​
token
string
required
The approval token sent to the reviewer.
Response:
StatusMeaning
PENDINGAwaiting response
APPROVEDApproved
REJECTEDRejected
TIMED_OUTTimeout passed without a response

​
Respond to approval

POST /api/v1/automation/approvals/{token}
​
token
string
required
The approval token.
Request body:
​
action
string
required
approve or reject
​
userId
string
Optional. ID of the user approving/rejecting.
curl -X POST "https://your-collabase.ch/api/v1/automation/approvals/tok-abc123" \
  -H "Content-Type: application/json" \
  -d '{ "action": "approve" }'

{ "status": "APPROVED", "resolvedAt": "2026-04-02T14:00:00.000Z" }