---
title: "Update a Kit Product"
method: PUT
path: "/wms/kits/{kit_id}"
tags: ["wms", "Kits"]
---

# Update a Kit Product

`PUT /wms/kits/{kit_id}`

Get the required, optional, and integration specific fields by calling the [integrations](/api-reference/mgmt/integrations) endpoint.

## Path parameters

- `kit_id` string, required

## Headers

- `x-trackstar-api-key` string, required
- `x-trackstar-access-token` string, required

## Request body

- union
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `sku` string, required — sku
    - `name` string — name
    - `gtin` string — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `measurements` ProductMeasurements
      - `length` number, nullable, required
      - `width` number, nullable, required
      - `height` number, nullable, required
      - `unit` 'cm' | 'in', nullable, required — The unit of measurement for the size of the product.
      - `weight` number, nullable, required
      - `weight_unit` 'kg' | 'oz' | 'lb', nullable, required — The unit of measurement for the weight of the product.
    - `inventory_items` WmsKitUpdateInventoryItem[], required — Inventory Items that make up this kit.
      - `sku` string, required — SKU of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `name` string — name
    - `sku` string — sku
    - `costing_method` 'FIFO' | 'Special - Batch' | 'Special - Serial Number' | 'FIFO - Serial Number' | 'FIFO - Batch' | 'FEFO - Batch' | 'FEFO - Serial Number' — Costing method for the product.
    - `inventory_items` WmsKitWriteInventoryItemdearSystems[], required — Inventory Items that make up this kit.
      - `inventory_item_id` string, required — Inventory Item ID of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `name` string — name
    - `gtin` string — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `warehouse_customer_id` string, nullable, required — The ID of the merchant/tenant/customer that owns the product. Can be passed into the [Warehouse Customer](/api-reference/wms-api/warehouse-customers/get-item) endpoint for more details.
    - `inventory_items` WmsKitWriteInventoryItemextensiv3plCentral[], required — Inventory Items that make up this kit.
      - `sku` string, required — SKU of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `warehouse_customer_id` string — ID of the warehouse customer that owns this product
    - `name` string — name
    - `gtin` string — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `touches` integer — The number of assembly points there are to build a single kit
    - `is_kit_on_demand` 'Yes' | 'No' — Whether this kit is built on demand (as in built at the point of fulfillment)
    - `inventory_items` WmsKitUpdateInventoryIteminfoplus[], required — Inventory Items that make up this kit.
      - `sku` string, required — SKU of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `name` string, required — name
    - `measurements` ProductMeasurementsmasonhub, required
      - `length` number, nullable, required
      - `width` number, nullable, required
      - `height` number, nullable, required
      - `unit` 'cm' | 'in', nullable, required — The unit of measurement for the size of the product.
      - `weight` number, nullable, required
      - `weight_unit` 'kg' | 'oz' | 'lb', nullable, required — The unit of measurement for the weight of the product.
    - `gtin` string — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `description` string, required — Description of the product.
    - `customer_bar_code` string, required — Customer provided bar code for this sku.
    - `brand_name` string, required — Brand name for this sku and product.
    - `category` string, required — Product category for this sku.
    - `sub_category` string, required — Product sub category for this sku.
    - `vendor_brand_code` string, required — Vendor provided brand code for identifying this sku.
    - `customer_brand_code` string, required — Customer provided brand code for identifying this sku. Used on packing lists.
    - `vendor_style` string, required — Vendor style code for item identification.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `name` string — name
    - `gtin` string — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `inventory_items` WmsKitUpdateInventoryItemongoing[], required — Inventory Items that make up this kit.
      - `sku` string, required — SKU of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `sku` string — sku
    - `name` string — name
    - `gtin` string — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `inventory_items` WmsKitCreateInventoryItemsandbox[] — Inventory Items that make up this kit.
      - `sku` string, required — SKU of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `name` string — name
    - `gtin` string — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `measurements` ProductMeasurementsshiphero
      - `length` number, nullable, required
      - `width` number, nullable, required
      - `height` number, nullable, required
      - `unit` 'cm' | 'in', nullable, required — The unit of measurement for the size of the product.
      - `weight` number, nullable, required
      - `weight_unit` 'kg' | 'oz' | 'lb', nullable, required — The unit of measurement for the weight of the product.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `name` string — name
    - `inventory_items` WmsKitUpdateInventoryItemshipstream[], required — Inventory Items that make up this kit.
      - `sku` string, required — SKU of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.
  - object
    - `trackstar_tags` unknown[], nullable — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `sku` string — sku
    - `name` string
    - `gtin` string, required — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `inventory_items` WmsKitWriteInventoryItemwhiplash[] — Inventory Items that make up this kit.
      - `sku` string, required — SKU of the kit component.
      - `unit_quantity` integer, required — Quantity of the kit component.

## Response `200`

Successful response

- WmsUpdateKitResponse
  - `data` WmsKitApiItemSchema
    - `id` string, required — The unique ID of the product.
    - `warehouse_customer_id` string, nullable, required — The ID of the merchant/tenant/customer that owns the product. Can be passed into the [Warehouse Customer](/api-reference/wms-api/warehouse-customers/get-item) endpoint for more details.
    - `created_date` string, date-time, required — The date the product was created.
    - `updated_date` string, date-time, required — The date the product was last updated.
    - `name` string, required — name
    - `sku` string, nullable, required — sku
    - `gtin` string, nullable, required — The Global Trade Item Number of the product. i.e. UPC, EAN, or ISBN.
    - `unit_price` number, nullable, required — The price of the product.
    - `inventory_items` ProductInventoryItems[], required — A list of inventory items associated with the product.
      - `inventory_item_id` string, required — ID of the inventory item. Can be passed into the [Inventory](/api-reference/wms-api/inventory/get-item) endpoint for more details.
      - `sku` string, nullable, required
      - `unit_quantity` integer, required — The number of units of the inventory item in the product.
    - `is_kit` boolean, required
    - `active` boolean, required — Whether the product is active.
    - `supplier_object` ProductSupplier, required
      - `supplier_id` string, required — The ID of the supplier.
      - `supplier_name` string, nullable, required — The name of the supplier.
    - `country_of_origin` string, nullable, required — The country of origin of the product.
    - `harmonized_code` string, nullable, required — The harmonized HS code of the product.
    - `supplier_products` ProductSupplierProducts[], required — A list of supplier products associated with the product.
      - `supplier_id` string, required — ID of the supplier.
      - `supplier_name` string, nullable, required — Name of the supplier.
      - `external_id` string, nullable, required — The external ID of the product from the supplier.
      - `unit_cost` string, nullable, required — The cost of the product from the supplier.
    - `categories` string[], required — A list of category names associated with the product.
    - `image_urls` string[], required — A list of image URLs associated with the product.
    - `external_system_url` string, nullable, required — URL link to the product in the external system (WMS/Freight etc).
    - `trackstar_tags` unknown[], nullable, required — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `additional_fields` object, required — Integration-specific fields
    - `trackstar_created_date` string, date-time, required
    - `trackstar_updated_date` string, date-time, required
  - `id` string, required — The ID of the object that has been created or modified
  - `unused_fields` string[], required — Unused fields

## Other responses

- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/trackstarhq/apis/trackstar-api.md) · [All operations](https://skmtc.net/trackstarhq/apis/trackstar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trackstarhq/trackstar-api/versions/4bc5c6e1a8bf/schema)