PATCH /v1/menu/products/{id}/position — move um produto para uma nova posição (a partir de 0) dentro da sua categoria. Os demais produtos dessa categoria se deslocam uma posição para abrir espaço. Uma posição maior que a última retorna 422.
PATCH /v1/menu/categories/{id} — move uma categoria para uma nova posição (a partir de 0; as demais categorias se deslocam uma posição) e/ou a mostra ou oculta com visible. Envie pelo menos um dos dois campos. Ocultar uma categoria oculta os produtos dela no menu. Categorias de favoritos não podem ser movidas (422).
GET /v1/menu agora retorna position em cada produto, para você ler a ordem atual antes de alterá-la.

Notas

Os dois endpoints usam o scope existente menu:write e estão disponíveis como ferramentas MCP (update_product_position, update_category).

🆕 Novo

GET /v1/menu/products/{id} (e POST /v1/menu/products) agora retornam modifier_categories: as categorias de modificadores do produto com seus modificadores (preços decimais e moeda), no mesmo formato de GET /v1/menu/modifier-categories. A associação é por produto — as mesmas categorias valem para todas as variantes. Categorias desativadas são excluídas.
GET /v1/menu agora retorna, em cada produto, modifier_category_ids: os UUIDs das categorias de modificadores do produto (desativadas excluídas). Somente ids — /v1/menu usa preços em unidades menores, enquanto as categorias de modificadores usam decimais; consulte os detalhes em GET /v1/menu/modifier-categories ou no produto individual.

Notas

🆕 Novo

GET /v1/menu/modifier-categories — Lista as categorias de modificadores da sua empresa (ex.: "Adicionais", "Escolha o pão"), cada uma com seus modificadores: id, name, type (one ou many), min_modifiers, max_modifiers, required, position e modifiers (id, name, price, original_price, currency, sku, max_limit, visible, position). Os preços são decimais, não unidades menores.
PUT /v1/menu/products/:id/modifier-categories — Substitui a associação de categorias de modificadores de um produto pelos modifier_category_ids informados, na ordem dada. O array pode ser vazio, o que desassocia todas as categorias de modificadores. Retorna o mesmo formato do endpoint de listagem, refletindo a associação resultante.
POST /v1/menu/products agora aceita um array opcional modifier_category_ids para associar categorias de modificadores ao produto na criação.

Notas

modifier_category_ids deve conter UUIDs distintos; duplicados ou ids de categorias inexistentes são rejeitados com 422.

🆕 Novo

POST /v1/menu/products — Cria um produto, opcionalmente com suas variantes, em uma única chamada.
POST /v1/menu/products/:id/variants — Cria uma variante para um produto existente.
PATCH /v1/menu/products/:id/variants/:variantId — Atualiza uma variante.
PATCH /v1/menu/products/:id agora também aceita visible, stock_enabled e messages_for_customers.
As respostas de GET de produto agora incluem stock_enabled e messages_for_customers.

2026-06-20 — Public API — Lançamento inicial

🆕 Novo

Primeira versão da OlaClick Public API está no ar.

Menu