Fiest Developers

Inspect a draft menu item for editing

Returns the exact editable state and opaque version for one item in one explicitly selected menu.

GET/v1/restaurants/{restaurantId}/menus/{menuId}/items/{catalogItemId}

Returns the exact editable state and opaque version for one item in one explicitly selected menu. The item can be edited only when the menu is inactive and the canonical item is not shared with another menu. Organization-boundary tokens also require fiest.organization.read; when a token covers several organizations, organization_id must identify an exact organization returned by listOrganizations.

Quick request

curl -X GET "https://example.com/v1/restaurants/11111111-1111-4111-8111-111111111111/menus/43f64da8-4ec2-4900-b137-1c0927c975d2/items/67fb6fb2-0f46-455b-934e-25707b77be08?organization_id=33333333-3333-4333-8333-333333333333" \  -H "Authorization: Bearer $FIEST_ACCESS_TOKEN"
{  "data": {    "restaurantId": "11111111-1111-4111-8111-111111111111",    "menu": {      "menuId": "43f64da8-4ec2-4900-b137-1c0927c975d2",      "name": "Lunch menu",      "isPosMenu": false,      "isOnlineMenu": false,      "categoryCount": 2,      "itemCount": 8    },    "item": {      "catalogItemId": "67fb6fb2-0f46-455b-934e-25707b77be08",      "categoryId": "af16a392-f8a1-47b4-849f-4d707001e9b1",      "name": "Margherita",      "basePriceMinor": 1350,      "description": "Tomato, mozzarella and basil",      "visible": true,      "showInKitchen": true    },    "sharedMenuCount": 1,    "canEdit": true,    "version": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"  }}

Authorization

fiestOAuth fiest.restaurant.read, fiest.menu.read, fiest.menu.structure.write
AuthorizationBearer <token>

OAuth 2.1 authorization code with PKCE. Partner clients and redirect URIs must be approved by Fiest before use.

In: header

Scope: fiest.restaurant.read, fiest.menu.read, fiest.menu.structure.write

Path Parameters

restaurantId*string

A restaurant identifier returned by the authorized restaurant list.

Formatuuid
menuId*string

The stable menu UUID returned by the menu list.

Formatuuid
catalogItemId*string

The stable catalog item UUID returned by catalog or menu item listing. It identifies the same food or drink item across menus.

Formatuuid

Query Parameters

organization_id?string

An organizationId returned by GET /v1/organizations. Required for restaurant-scoped calls when a Management portfolio authorization covers more than one organization; omitted for a single-restaurant authorization and optional for a one-organization grant.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Add existing items to a draft menu

Adds up to 50 existing restaurant menu items to one inactive menu. Expected counts prevent applying the request to a menu that changed after review.

Update a draft menu item

Updates only reviewed name, price, description, visibility, or kitchen-display fields on one unshared item in one inactive draft.