Apply Supplier Confirmed Changes
POST/api/purchase-orders/:purchase_order/supplier-responses/:response/apply
Apply a changes_requested supplier response's confirmed line quantities back onto the live purchase order. Each confirmed quantity is written to its line, respecting the floors already received or invoiced on that line so committed quantities are never reduced below what has already happened.
Applying the confirmed changes creates a divergence between the live order and the last revision the supplier received, which the buyer then re-sends as a new revision.
Path params:
purchase_order(required): id of the purchase order.response(required): id of the supplier response to apply.
No request body.
Response under data: the refreshed purchase_order, an applied count of lines updated, and a skipped[] array describing any lines that could not be changed.
Authentication: Requires Bearer token.
Requires permission: purchase_orders.update
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.