Assign a product to a bin
Creates a BinnedProduct assignment row. quantity is informational
(the SSOT for true on-hand remains inventory.inventory_balances).
is_default_bin marks the preferred bin for the product within the
bin’s location. Idempotent on Idempotency-Key. Requires the
bins: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
Response
Created binned-product assignment
A product-bin assignment row, returned by GET /bins/{id}/products and written by POST /bins/{id}/products. Quantity is informational (not the SSOT for inventory_balances). is_default_bin marks the preferred bin for the product within its location. Scope: bins:read / bins:write.
"binned_product"
Optional reported quantity. SSOT for true on-hand is inventory.inventory_balances.

