Commit a multi-warehouse allocation plan (per-location reservations)
Applies a sourcing plan by creating per-location reservations through the canonical
reservation doorway (each warehouse leg reserves independently; the over-allocation
gate fires per leg). Idempotent: re-running releases any existing reservations for the
order, then re-reserves per the plan. The body may carry an operator-edited plan; if
omitted, the system auto-plan (preferred location first, then most-available) is used
for every physical line. Posts NO journal entry (reservation is not a GL event,
AICPA ASC 606). Requires orders:write scope. Idempotent via the Idempotency-Key
header.
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
Optional operator-edited plan. When omitted, the system auto-plan is used.
Response
The committed allocation plan.

