Update Warehouse Location

PUT 
/api/v2/warehouse-locations/:warehouseLocation

Update a warehouse location. All fields are optional (sometimes); only provided fields are changed.

Authentication: Requires Bearer token. Scope: warehouses (read/write).

Body fields (all optional):

• code (nullable, string max 64)
• name (nullable, string max 255)
• zone (nullable, string max 32)
• aisle / bay / shelf / bin (nullable, string max 255)
• type (enum: staging, primary_pick, reserve, storage, shipping, returns, quarantine, damaged)
• is_receivable (optional, boolean) — bin can receive stock on inbound receipts
• is_pickable (optional, boolean) — bin is eligible for order picking
• is_putaway_source (optional, boolean) — stock can be drawn from this bin during put-away
• is_putaway_destination (optional, boolean) — stock can be put away into this bin When a capability flag is omitted it is seeded from the location type defaults; once set, receiving, picking and put-away routing follow the flags, not the type.
• barcode (nullable, string max 64)
• sort_order (nullable, integer min 0)
• is_default (boolean)

Requires permission: warehouses.manage_locations

Request

Responses

200

OK

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

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.

429

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.