Skip to main content
PUT
/
v1
/
inventory
/
warehouses
/
{id}
/
locations
/
{location_id}
Update Location
curl --request PUT \
  --url https://{base_url_domain}/api/global/v1/inventory/warehouses/{id}/locations/{location_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "A4-55-C3",
  "priority": 10,
  "is_type_auto": true,
  "lot": {
    "type": "Lot",
    "id": 54
  },
  "product": {
    "type": "Product",
    "id": 123
  },
  "rack": {
    "type": "Rack",
    "id": 123
  },
  "location_type": {
    "type": "LocationType",
    "id": 54
  }
}
'
{
  "errors": [
    {
      "type": "parameters",
      "message": "The supplied parameters are invalid.",
      "details": [
        {
          "key": "hold_until_date",
          "message": "The date must be in the future."
        }
      ]
    }
  ]
}

Authorizations

ā€‹
Authorization
string
header
required

Generate a JWT access token through a Custom Global Integration and provide it with each request in the Authorization header prefixed with "Bearer" and then a single space.

Path Parameters

ā€‹
id
integer<int32>
required

The id of the referenced Warehouse.

ā€‹
location_id
integer<int32>
required

The id of the referenced Location.

Body

application/json

A Location object specifying the fields to be updated.

A Location describes a user-specified inventory address within a warehouse.

ā€‹
label
string | null

The human-readable name of a location and also the value encoded in location's barcode label. This value must be unique within each warehouse.

Example:

"A4-55-C3"

ā€‹
priority
integer

The inventory reservation order relative to other locations containing the same product.

Example:

10

ā€‹
is_type_auto
boolean | null

If Location Type is "Automatic" then it will cause the type to be maintained automatically according to the Auto-Assign Patterns of the location types.
Optional Field

Example:

true

ā€‹
lot
LotRef Ā· object

A reference to the Lot object assigned to this location.

ā€‹
product
StockableProductRef Ā· object

A reference to the stockable product assigned to this location.

ā€‹
rack
RackRef Ā· object

A reference to the Rack to which this location is assigned. This may be managed automatically or assigned manually.

ā€‹
location_type
LocationTypeRef Ā· object

A reference to the LocationType object assigned to this location. This may be managed automatically or assigned manually.

Response

OK - The operation completed successfully and there is no response body.