Sign in
invoices

Approve an invoice at a specific policy tier

Records the authenticated user's approval at a specific Advanced Policy tier without force-approving the entire invoice. Approval is implicit for the authenticated user at the named policy tier.

policy_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}/approve-policy

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

policy_idstring required

Policy ID

Response

Successful response with updated invoice approval state

InvoicesPostInvoicesIdApprovePolicyResponse200 required

Empty response body

Changes