Fiest Developers

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.

POST/v1/restaurants/{restaurantId}/menus/{menuId}/items

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. 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 POST "https://example.com/v1/restaurants/11111111-1111-4111-8111-111111111111/menus/43f64da8-4ec2-4900-b137-1c0927c975d2/items?organization_id=33333333-3333-4333-8333-333333333333" \  -H "Authorization: Bearer $FIEST_ACCESS_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "catalogItemIds": [      "67fb6fb2-0f46-455b-934e-25707b77be08",      "77777777-7777-4777-8777-777777777777"    ],    "expectedCategoryCount": 2,    "expectedItemCount": 8,    "idempotencyKey": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",    "confirmed": true  }'
{  "data": {    "actionId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",    "restaurantId": "11111111-1111-4111-8111-111111111111",    "menu": {      "menuId": "43f64da8-4ec2-4900-b137-1c0927c975d2",      "name": "Lunch menu",      "isPosMenu": false,      "isOnlineMenu": false,      "categoryCount": 2,      "itemCount": 10    },    "addedCatalogItemIds": [      "67fb6fb2-0f46-455b-934e-25707b77be08",      "77777777-7777-4777-8777-777777777777"    ],    "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

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