Update Warehouse
PUT/api/warehouses/:warehouse
Updates an existing warehouse. Accepts the same fields as Create Warehouse; all fields are optional on update.
warehouses:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Address fields (address1, city, zip, country_code, etc.) update the warehouse's address record. Setting is_default on a supplier warehouse makes it that supplier's default warehouse. Toggling auto_routing_enabled adds or removes the warehouse from the automatic order-routing priority list.
Returns 400 when disabling dropshipping on a warehouse that still has open dropship orders.
Authentication: Requires Bearer token.
Also accepts (3PL warehouses): fba_inbound_reminders_enabled (boolean) and fba_inbound_reminder_days (array of positive integer day-offsets, e.g. [3,7,14]) — controls automatic FBA-inbound turnaround reminders to this 3PL.
WFS inbound-reminder settings (opt-in turnaround nudges for WFS inbound shipments sourced from this 3PL/warehouse):
- wfs_inbound_reminders_enabled (boolean, optional): enable per-warehouse WFS inbound turnaround reminders.
- wfs_inbound_reminder_days (int[], optional, nullable, each 1–365): days-after-send cadence to remind on (default [3, 7, 14] when reminders are enabled and none provided).
negative_bin_policy (optional; one of block, warn, allow; default warn) controls how the warehouse reacts when an outbound movement would drive a specific bin's on-hand below zero: block rejects the movement, warn permits it but flags the shortfall, and allow permits it silently. The warehouse's default catch-all location is always exempt.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Bad Request
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.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.
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.