Accept a freight quote and roll its amount into shipping_total
Marks one freight_quotes row as accepted (accepted_at = now(),
accepted_by_id = <api key user>) and recomputes the parent order’s
shipping_total to include this quote’s amount. Only one quote per order
may be accepted at a time; the canonical helper enforces this invariant
(Rule 23 SSOT for freight_quotes.accepted_at). Returns 404
quote_not_found when the quote is missing or belongs to a different
entity. Idempotent on Idempotency-Key. Requires the orders:write scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_
Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Body
Empty body accepted; the quote id in the path is sufficient.
Response
Quote accepted; order shipping_total updated

