Reorder Preferred Bins
PUT/api/v2/product-warehouse-locations/reorder
Reorder a product's preferred bins in a warehouse to match the given id order (top to bottom) and return the fresh ordered list. Priorities are rewritten 0-based and the new top bin becomes the default, so the ordered list matches the resolution order used by put-away and receiving.
Body fields:
- product_id (required) — product whose bins are reordered.
- warehouse_id (required) — warehouse the bins live in.
- ids (required, array of integers) — assignment ids in the desired order; must be exactly the product+warehouse's current assignments.
Authentication: Requires Bearer token. Scope: warehouses (read/write). Requires the warehouses.manage_locations permission.
Request
Responses
- 200
- 401
- 403
- 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.
Unprocessable Entity
Response Headers
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.