Next release: a discount with a rate per product#
- New:
POST /v1/api/promotions/discountandPATCH /v1/api/promotions/discount/{id}takeproduct_discounts: [{ sku, discount_type, value }], a rate per SKU off every unit of it (up to 500 SKUs), instead ofdiscount_type,valueandapplies_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/productsansweredstock: { on_hand: null, available: null }for every product. It now returns the counted and sellable numbers. - Variants: a new variant (
parent_sku) that gives nocategoryorbrandtakes 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/mcpfor Claude, ChatGPT, Gemini Enterprise and Gemini CLI. You sign in with SellerSideKick and choose the shop and permissions. See Connect ChatGPT, Claude or Gemini. - 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 answers403 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.txtand 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.