> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tiankii.com/_mcp/server.

# Overview

## Products — Base: `/v1/products`

**Products** are the items in the store's **catalog/menu** — what the merchant sells. Together with their **modifiers** (variations or extras: size, ingredients, add-ons…) and their **categories**, they form the catalog that belongs to the **place**.

A **place** is an **app** (sale terminal / POS / location): the point where products are offered. A product is linked to one or more places (its *locations*) so it appears on those terminals.

This folder covers product CRUD plus reading its relations:

* `GET /products/:productId/modifiers` — the product's modifiers.

* `GET /products/:productId/locations` — the places/apps where it is available.

The **Modifiers** subfolder covers the full modifier CRUD under `/v1/product-modifiers` and the product↔modifier linking.

Related (outside this folder):

* **Categories** — managed under `/product-categories`, but **JWT/admin only** (they do not accept API key), which is why they are not in this collection.

Scopes: `Merchant.product.{read,create,update,delete}`.

## Docs

- [Overview](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers.md)

## API Docs

- Modifiers [List modifiers](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers/list.md)
- Modifiers [Create modifier](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers/create.md)
- Modifiers [Get modifier](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers/get.md)
- Modifiers [Replace modifier](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers/replace.md)
- Modifiers [Delete modifier](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers/delete.md)
- Modifiers [Link products to modifier](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers/link-products.md)
- Modifiers [List modifier products](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/modifiers/list-products.md)
- Products [List products](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/list.md)
- Products [Create product](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/create.md)
- Products [Get product](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/get.md)
- Products [Delete product](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/delete.md)
- Products [Update product](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/update.md)
- Products [List product modifiers](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/list-modifiers.md)
- Products [List product locations](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/list-locations.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/openapi.json)
- [OpenAPI YAML](https://docs.tiankii.com/api-reference/tiankii-api-api-key/products/openapi.yaml)