Unlock Sales Order Line Warehouse
POST/api/sales-order-lines/:salesOrderLine/unlock-warehouse
Release a sales order line's locked warehouse so it follows its sales channel's location again.
orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
A line is locked when its warehouse was set deliberately — by moving or splitting the line, moving its fulfillment order, or editing the order's line warehouse. While locked, the line reports warehouse_location_locked: true and sales channel location changes (for example, changing an order's fulfillment location in Shopify) do not move it.
Unlocking clears the lock and immediately re-applies the channel's current location: if that location maps to a different warehouse, the line moves there together with its inventory reservation. Lines already shipped are never moved. Unlocking a line that is not locked is a no-op.
No request body.
Requires the sales_orders.update permission.
Returns the refreshed sales order (same shape as Get Sales Order).
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
Response Headers
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.