Update a purchase request
PUT/purchase-requests/:code
Updates an existing purchase request (only allowed in DRAFT status). All fields are optional.
Permissions: requires purchase-requests:write (granted by can_buy). payment_method=INVOICE additionally requires can_pay_on_invoice; a foreign buyer_code requires can_purchase_on_behalf. Object-level: non-viewers get 404, viewers that are neither owner nor admin get 403, non-DRAFT requests get 409.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
Purchase request updated successfully
Bad request - validation error or invalid status
Unauthorized
Forbidden - request denied by authorization, or blocked by the API firewall
Purchase request not found
Purchase request is no longer in DRAFT status
Supplier is blocked
Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying
Response Headers
Delay in seconds a client must wait before retrying the request
Internal server error