Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.foodsave.kz/llms.txt

Use this file to discover all available pages before exploring further.

Menu API

Base path: /api/v1/menu

Overview

Manage menu items, categories, CSV imports and POS synchronization for a partner account.
CSV column names must match the importer schema exactly. Invalid rows are skipped and reported in the response summary.

GET /api/v1/menu/items

List current partner menu items.
[{ "id":"m-1", "name":"Croissant", "price":450, "archived":false }]

GET /api/v1/menu/categories

List menu categories.
[{ "id":"c-1", "name":"Breakfast" }]

POST /api/v1/menu/items

Create a menu item.
curl --request POST \
  --url https://api.foodsave.kz/api/v1/menu/items \
  -H 'Authorization: Bearer $PARTNER_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Croissant","category":"Breakfast","price":450}'
{ "id":"m-1", "name":"Croissant", "price":450, "archived":false }

PUT /api/v1/menu/items/{id}

Update a menu item.
{ "id":"m-1", "name":"Croissant Deluxe", "price":550 }

DELETE /api/v1/menu/items/{id}

Archive a menu item.
{}

POST /api/v1/menu/import/csv

Import a CSV menu.
{ "created": 14, "updated": 4, "failed": 1 }

POST /api/v1/menu/pos/sync

Trigger POS sync.
{ "itemsSynced": 8, "itemsFailed": 0 }