Approvals

API Reference

DraftLast reviewed 2026-06-23

Approval request lifecycle — list, read, approve, reject, escalate

📄️Reject an approval request

Records a rejection. Cancels all remaining PENDING and BLOCKED steps in the chain. Comment is required.

📄️Escalate an approval request

Manually sets the request status to ESCALATED. Automated escalation runs via the batch job.

📄️Approve an approval request

Records an approval decision. Unblocks the next step in the chain if one exists.

📄️List approvals

Returns approval requests filtered by optional entity_type, entity_id, and status. When no filters are supplied, only PENDING approvals are returned.

📄️Get an approval request by ID

Returns the full approval request record including current status and decision details.