xclade
Admin APIInventory items

Update an Inventory Item

Update an inventory item's details.

POST
/admin/inventory-items/{id}
AuthorizationBearer <token>

In: header

Path Parameters

id*string

The inventory item's ID.

Query Parameters

fields?string

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields.

Request Body

application/json

sku?string

The inventory item's SKU.

hs_code?string

The inventory item's HS code.

weight?number

The inventory item's weight.

length?number

The inventory item's length.

height?number

The inventory item's height.

width?number

The inventory item's width.

origin_country?string

The inventory item's origin country.

mid_code?string

The inventory item's MID code.

material?string

The inventory item's material.

title?string

The inventory item's title.

description?string

The inventory item's description.

requires_shipping?boolean

Whether the inventory item requires shipping.

thumbnail?string

The URL of an image to be used as the inventory item's thumbnail. You can use the Upload API routes to upload an image and get its URL.

metadata?object

The inventory item's metadata. Can be custom data in key-value pairs.

Response Body

application/json

application/json

text/plain

application/json

application/json

application/json

application/json

curl -X POST "https://{tenant}.api.myxclade.com/admin/inventory-items/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "inventory_item": {
    "id": "string",
    "sku": "string",
    "origin_country": "string",
    "hs_code": "string",
    "requires_shipping": true,
    "mid_code": "string",
    "material": "string",
    "weight": 0,
    "length": 0,
    "height": 0,
    "width": 0,
    "title": "string",
    "description": "string",
    "thumbnail": "string",
    "metadata": {},
    "location_levels": [
      {
        "id": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z",
        "inventory_item_id": "string",
        "location_id": "string",
        "stocked_quantity": 0,
        "reserved_quantity": 0,
        "incoming_quantity": 0,
        "metadata": {},
        "inventory_item": {},
        "available_quantity": 0
      }
    ]
  }
}

{
  "message": "Discount must be set to dynamic",
  "type": "not_allowed"
}

"Unauthorized"
{
  "message": "Entity with id 1 was not found",
  "type": "not_found"
}
{
  "code": "unknown_error",
  "message": "The request conflicted with another request. You may retry the request with the provided Idempotency-Key.",
  "type": "QueryRunnerAlreadyReleasedError"
}
{
  "code": "invalid_request_error",
  "message": "Discount with code TEST already exists.",
  "type": "duplicate_error"
}

{
  "code": "api_error",
  "message": "An error occured while hashing password",
  "type": "database_error"
}