Fiest Developers

Update a draft menu item

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

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

Updates only reviewed name, price, description, visibility, or kitchen-display fields on one unshared item in one inactive draft. Pass the unchanged version returned by the inspection operation so a concurrent edit fails safely. This operation never publishes the 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 PATCH "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" \  -H "Content-Type: application/json" \  -d '{    "expectedVersion": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "changes": {      "name": "Margherita classica",      "basePriceMinor": 1450    },    "idempotencyKey": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",    "confirmed": true  }'
{  "data": {    "actionId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",    "restaurantId": "11111111-1111-4111-8111-111111111111",    "menuId": "43f64da8-4ec2-4900-b137-1c0927c975d2",    "item": {      "catalogItemId": "67fb6fb2-0f46-455b-934e-25707b77be08",      "categoryId": "af16a392-f8a1-47b4-849f-4d707001e9b1",      "name": "Margherita classica",      "basePriceMinor": 1450,      "description": "Tomato, mozzarella and basil",      "visible": true,      "showInKitchen": true    },    "previousVersion": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "version": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",    "replayed": false  }}

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json