Request approval for a purchase request
POST/purchase-requests/:code/request-approval
Submits a purchase request for approval, triggering the approval workflow
Permissions: requires purchase-requests:write (granted by can_buy). Object-level: non-viewers get 404, viewers that are neither owner nor admin get 403.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
Approval requested successfully
Bad request - code missing or invalid status
Unauthorized
Forbidden - request denied by authorization, or blocked by the API firewall
Purchase request not found
Conflict - status changed, or the approval rules named no resolvable approver
Supplier is blocked
Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying
Response Headers
Retry-After
Delay in seconds a client must wait before retrying the request
Internal server error