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

Example Request
curl -X PATCH 'https://api-sandbox.fiest.io/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}'
Example Response
{  "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
headerAuthorizationBearer <token>

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

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
  1. body
expectedVersion*string
Match^[a-f0-9]{64}$
changes*
idempotencyKey*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
confirmed*boolean

Response Body

The committed draft-menu item state.

application/json
  1. response
data*