Skip to main content

Approve Approval Request

POST 
/api/approval-requests/:approvalRequest/approve

Approve the current step of a pending approval request. When this completes the last step the request becomes approved and the document moves on (a purchase order opens — and is sent to the supplier if that was requested — a vendor deposit or bill payment is approved). Otherwise the request advances to the next step and its approvers are notified.

Required scope: purchase-orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token with the purchase-orders scope (read for GET, write for POST/PUT/DELETE). You must be eligible for the current step: listed on it, a member of a listed role, listed on a higher tier, or an active delegate of someone eligible.

Body fields:

  • notes (string, optional, max 1000)

The message tells you whether the request completed (Approved.) or is waiting on the next step.

Error responses carry a machine-readable code next to the human message:

  • 403 approval_limit_exceeded — you are not eligible for the current step (over your limit, your own request under separation of duties, or you already decided this step). Other 403 codes: approval_withdraw_forbidden, approval_remind_forbidden, approval_override_forbidden, approval_reroute_forbidden.
  • 409 approval_state_conflict — the request is no longer pending (already approved, rejected, withdrawn, or superseded by a newer request after the document changed). Re-read it and act on the current request.
  • 404 — the approval request does not exist.

Request​

Responses​

OK

Response Headers
    Content-Type