# Changelog

> Changes to the shop API, the AI-assistant connector and these docs, newest first.

## Next release: the chat bot's Playbook, FAQ and greeting

- **New permission:** `bot:write`. Keys with full access have it; a key or connection with chosen permissions needs it added (a new key, or reconnect and tick it).
- **New:** `GET /v1/api/bot` reads the Playbook and the FAQ; `POST /v1/api/bot/playbook` replaces the Playbook; `POST /v1/api/bot/faq` adds, updates or (with `mode: "replace"`) removes questions. All writes take `dry_run`. See [Update the chat bot's Playbook and FAQ](https://docs.sellersidekick.ai/update-bot).
- **Connector:** `get_bot_playbook_and_faq`, `preview_playbook_update` / `apply_playbook_update`, `preview_faq_update` / `apply_faq_update`.
- **New:** `POST /v1/api/bot/greeting` changes the greeting new conversations on LINE, Facebook and Instagram open with: the text, then up to 10 videos, pictures or sets of product cards, each with an optional `message` sent right after it. `POST /v1/api/bot/greeting/media` uploads its videos and pictures. `GET /v1/api/bot` answers it as `greeting`. API only for now. See [Update the chat bot's Playbook, FAQ and greeting](https://docs.sellersidekick.ai/update-bot#greeting).

## 2026-10-30: product pictures

- **New:** product rows in `POST /v1/api/products/upsert` (and the connector's catalogue tools) take `images`: 1 to 7 picture links, copied onto SellerSideKick. See [Add new products](https://docs.sellersidekick.ai/add-products#pictures).
- **New:** `POST /v1/api/images` uploads pictures as files (multipart) and answers their links.
- `GET /v1/api/products` answers each product's `images`.

## Next release: feature a discount in the chat bot

- **New:** `POST /v1/api/promotions/discount` and `PATCH /v1/api/promotions/discount/{id}` take
  `bot_feature: { enabled, announcement_th, announcement_en }` (announcements up to 400 characters). While the
  discount runs, the shop's chat bot on LINE, Facebook, Instagram and web chat opens conversations with the
  announcement and recommends the discount's products first. Discounts read back with it. See
  [Promotions](https://docs.sellersidekick.ai/promotions).
- **New:** bundles and BOGOs take `bot_feature` too, and read back with it.

## Next release: bigger promotion product lists

- **Changed:** a promotion's product list (`product_discounts`, `applies_to.skus`) now takes up to **5,000 SKUs**,
  up from 500. It is sent whole in one request, because an update replaces the saved list. Product and stock
  writes stay at 500 rows per request.

## Next release: a discount with a rate per product

- **New:** `POST /v1/api/promotions/discount` and `PATCH /v1/api/promotions/discount/{id}` take
  `product_discounts: [{ sku, discount_type, value }]`, a rate per SKU off every unit of it (up to 500 SKUs at first, 5,000 since),
  instead of `discount_type`, `value` and `applies_to`. One promotion holds the whole sale, so it switches
  on and off at once. It reads back the same way it is written.

## Next release: stock read-back and simpler variants

- **Fixed:** `GET /v1/api/products` answered `stock: { on_hand: null, available: null }` for every product. It now returns the counted and sellable numbers.
- **Variants:** a new variant (`parent_sku`) that gives no `category` or `brand` takes the main product's. Anything the row gives still wins.
- **Clearer errors:** a new product missing several required fields is told all of them at once, for example `A new product needs name, price and brand.`

## Permissions, key expiry and the AI-assistant connector

- **Connector** at `https://mcp.sellersidekick.ai/mcp` for Claude, ChatGPT, Gemini Enterprise and Gemini CLI. You sign in with SellerSideKick and choose the shop and permissions. See [Connect ChatGPT, Claude or Gemini](https://docs.sellersidekick.ai/connect-ai-assistant).
- **Permissions on API keys:** `catalog:read`, `catalog:write`, `stock:write`, `promotions:write`. Existing keys and new keys default to full access. A call outside a key's permissions answers `403 Y35`.
- **Key expiry:** never, 30, 90 or 365 days, with a reminder email 7 days before. An expired key answers `401 Y22`.
- **Connected AI assistants** are listed in **Settings → API keys**, each with a Disconnect button. **Recent API changes** there shows what keys and assistants changed, before and after.
- **Change log** in **Settings → API keys**: every change made through a key or an assistant, with the value before and after.
- These docs, `llms.txt` and a Markdown copy of every page.

## 2026-10-25: OpenAPI spec 1.1.0 and usage counters

- The OpenAPI spec is published at `https://api.sellersidekick.ai/v1/api/openapi.json`, written for AI agents: when to call each operation, what to check first, whether a retry is safe, with examples.
- **Usage counters** per key and per shop in **Settings → API keys**: calls, errors, rate-limited calls, dry runs and rows written, today and over the last 30 days.
