Sign in
invoices

Revoke an invoice approval step

Undoes a specific user's approval step on an invoice and recalculates dependent policy tiers. Requires the can_undo_invoice_approvals permission.

approval_id is carried in the request body rather than the URL path (unlike the path shown in the original spec) — the 4-segment path documented there exceeds the max depth this API Gateway resource tree supports (3 segments; see ottiapi/modules/api_endpoint_tree/main.tf's depth_1/2/3_paths locals).

post/invoices/{id}/revoke-approval

Path parameters

idstring required

Invoice ID

Headers

Authorizationstring required

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-Keystring required

API key for authentication

X-API-Versionstring

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.

Idempotency-Keystring

Client-generated unique key (UUID/ULID recommended). JSON requests: the first 2xx response is cached for 24h and replayed on a same-key retry with a matching body; a different body returns 422. Non-JSON requests (e.g. file uploads): the key is single-use — any same-key retry returns 422 regardless of body. See Idempotency for full details.

Request body

approval_idstring required

Object approval record ID, e.g. pbjappr_550e8400...

Response

Successful response with updated invoice approval state

InvoicesPostInvoicesIdRevokeApprovalResponse200 required

Empty response body

Changes