> ## Documentation Index > Fetch the complete documentation index at: https://docs.trackstarhq.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Trackstar is a unified REST API for WMS, cart, and carrier systems. Base URL: https://production.trackstarhq.com. There is no SDK; call the API with plain HTTP. > Send x-trackstar-api-key on every request. Endpoints scoped to one connection also need x-trackstar-access-token. Read both from environment variables and never print them. > Reads return data Trackstar has already synced from the connected system. Writes (POST, PUT, PATCH, DELETE) are forwarded to the connected system immediately. > A new connection has no data until its initial sync finishes. Wait for the connection.historical-sync-completed webhook, or poll GET /connections/{connection_id} and check historical_sync_completed. > List endpoints page with page_token and next_token (limit is capped at 1000). Repeat every filter on every page. Filters use field[operator]=value, for example created_date[gte]=2026-01-01T00:00:00Z. > Write bodies must not contain null or empty strings; omit the field instead. Call GET /integrations/{integration_type}/{integration_name}/write-info first to learn the exact fields an integration accepts. > To test without real credentials, POST /sandbox/generate-sandbox/{wms|cart|carrier} with the API key returns a sandbox access token. Start at https://docs.trackstarhq.com/how-to-guides/build-with-ai.md and install the skills with: npx skills add https://docs.trackstarhq.com # Update Cart Product Trackstar Tags > Update the trackstar tags for the specified cart product. ## OpenAPI ````yaml put /cart/products/{product_id}/trackstar-tags openapi: 3.1.0 info: description: > Trackstar is a Unified API that provides standard endpoints for Supply Chain Logistics. We currently offer an API for Warehouse Management Systems (WMS). title: Trackstar API version: 0.1.0 servers: - description: Trackstar API url: https://production.trackstarhq.com security: [] tags: [] externalDocs: description: Trackstar API Documentation url: https://docs.trackstarhq.com paths: /cart/products/{product_id}/trackstar-tags: put: tags: - cart - Products summary: Update Cart Product Trackstar Tags description: Update the trackstar tags for the specified cart product. operationId: put_cart_update_product_trackstar_tags parameters: - in: path name: product_id schema: type: string required: true - in: header name: x-trackstar-api-key description: Your organization-level Trackstar API key. schema: type: string example: required: true - in: header name: x-trackstar-access-token description: >- Your user's access token for a specific integration (ShipHero, Extensiv, etc). schema: type: string example: required: true - in: header name: Idempotency-Key description: >- Optional key that makes this request safe to retry. Send the same key on a retry and Trackstar returns the first attempt's response instead of writing again; if the first attempt failed, the retry runs the write again. Reusing a key with a different request is rejected. Keys expire after 24 hours. schema: type: string minLength: 1 maxLength: 255 example: 9f1c2b1e-6d4a-4c1c-9a8e-2b7e3c5d1f00 required: false requestBody: content: application/json: schema: $ref: '#/components/schemas/AddTrackstarTagproductsSchema' responses: '200': content: application/json: schema: $ref: '#/components/schemas/cartAddTrackstarTagProductResponse' description: Successful response '404': content: application/json: schema: $ref: '#/components/schemas/HTTPError' description: Not found '422': content: application/json: schema: $ref: '#/components/schemas/ValidationError' description: Validation error components: schemas: AddTrackstarTagproductsSchema: type: object properties: trackstar_tags: type: array description: >- A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair. example: - tag1 - tag2 - tag3: value3 items: {} required: - trackstar_tags additionalProperties: false title: AddTrackstarTagproductsSchema cartAddTrackstarTagProductResponse: type: object properties: data: $ref: '#/components/schemas/AddCartProductsTagsResponseDataSchema' id: type: string description: The ID of the object that has been created or modified example: id unused_fields: type: array description: Unused fields items: type: string description: '' example: unused_fields required: - id - unused_fields additionalProperties: false title: cartAddTrackstarTagProductResponse HTTPError: properties: error: type: string id: type: string description: The ID of the item that wasn't found. required: - error type: object title: HTTPError ValidationError: properties: error: type: string detail: type: object properties: : type: object properties: : type: array items: type: string required: - error type: object title: ValidationError AddCartProductsTagsResponseDataSchema: type: object properties: id: type: string description: The unique ID of the product. example: product_id created_date: type: string format: date-time description: The date the cart product was created. example: '2022-01-01T00:00:00Z' updated_date: type: string format: date-time description: The date the cart product was last updated. example: '2022-01-02T05:05:05Z' name: type: string description: The name of the product. example: product_name sku: type: - string - 'null' description: The SKU of the product. example: sku gtin: type: - string - 'null' description: The GTIN of the product. example: gtin parent_product_id: type: string description: >- If this is a variant, the ID of the parent product. If this is a parent product, this field should be the same as ID. example: parent_product_id is_kit: type: boolean description: '' example: true active: type: boolean description: Whether the product is active. example: true image_url: type: - string - 'null' description: The URL of the product's image. example: https://example.com/image.jpg price: type: - number - 'null' description: >- The price of the product if it is a variant. Not the source of truth for parent products. example: 10 unit_cost: type: - number - 'null' description: >- The unit cost of the product if it is a variant. Not the source of truth for parent products. example: 10 inventory: type: - integer - 'null' description: >- The inventory of the product if it is a variant. Not the source of truth for parent products. example: 10 inventory_by_warehouse_id: type: object description: Inventory broken down by warehouse. example: warehouse_id_1: 6 warehouse_id_2: 4 additionalProperties: type: integer description: Inventory for that warehouse. example: 5 measurements: $ref: '#/components/schemas/ProductMeasurements' tags: type: array description: >- A list of tags associated with the product. Tags that are represented as key-value pairs in the underlying system will be represented as a single string formatted as `key:value`. example: - tag_0 items: type: string description: A tag associated with the product. example: tag_0 categories: type: array description: >- A list of category names the product belongs to. For platforms with a hierarchical category tree, each level is a separate element with the leaf last (e.g. ["Apparel", "Shoes", "Running"]). For platforms with a single scalar product type, a single-element list. example: - Apparel - Shoes - Running items: type: string description: A category name. example: Apparel external_system_url: type: - string - 'null' description: >- URL link to the cart product in the external system (WMS/Freight etc). example: https://example.com/cartproduct/123 trackstar_tags: type: - array - 'null' description: >- A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair. example: - tag1 - tag2 - tag3: value3 items: {} additional_fields: type: object description: Integration-specific fields example: key: value additionalProperties: {} required: - active - additional_fields - categories - created_date - external_system_url - gtin - id - image_url - inventory - inventory_by_warehouse_id - is_kit - measurements - name - parent_product_id - price - sku - tags - trackstar_tags - unit_cost - updated_date additionalProperties: false title: AddCartProductsTagsResponseDataSchema ProductMeasurements: type: object properties: length: type: - number - 'null' description: '' example: 1.5 width: type: - number - 'null' description: '' example: 1.5 height: type: - number - 'null' description: '' example: 1.5 unit: type: - string - 'null' enum: - cm - in description: The unit of measurement for the size of the product. example: in weight: type: - number - 'null' description: '' example: 2.5 weight_unit: type: - string - 'null' enum: - kg - oz - lb description: The unit of measurement for the weight of the product. example: lb required: - height - length - unit - weight - weight_unit - width additionalProperties: false title: ProductMeasurements ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.