Skip to content
openapi
/
/
Create menu item

Create menu item

Request

Create a new menu item.

Security
OAuth2(Required scopes: menu:write)
Bodymultipart/form-datarequired
categorystringrequired

Menu item category.

Enum:"beverage""dessert"
Discriminator
Value:"beverage"
volumenumber, > 0required

Size of the beverage in milliliters.

containsCaffeinebooleanrequired

Indicates if the beverage contains caffeine.

namestring, [ 1 .. 50 ] charactersrequired

Menu item name.

priceinteger, >= 0required

Price in cents.

photostring or null, (binary)write-only

Photo of the menu item. Must be a PNG image less than 1MB in size.

photoTextDescriptionstring or null
curl -i -X POST \
  https://cafe.redocly.com/_mock/openapi/cafe/menu \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: multipart/form-data' \
  -F name=Cappuccino \
  -F price=4500 \
  -F category=beverage \
  -F volume=250 \
  -F containsCaffeine=true \
  -F 'photoTextDescription=A hot cappuccino in a white ceramic cup.'

Responses

Menu item created successfully.

Bodyapplication/json
categorystringrequired

Menu item category.

Enum:"beverage""dessert"
Discriminator
Value:"beverage"
volumenumber, > 0required

Size of the beverage in milliliters.

containsCaffeinebooleanrequired

Indicates if the beverage contains caffeine.

createdAtstring, (date-time)read-onlyrequired

Created date.

updatedAtstring, (date-time)read-onlyrequired

Updated date.

idstring^prd_[0-9abcdefghjkmnpqrstvwxyz]{26}$read-onlyrequired

Menu item ID. Unique identifier prefixed with prd_.

Example:"prd_01h1s5z6vf2mm1mz3hevnn9va7"
objectstringread-onlyrequired

Entity name.

Value:"menuItem"
namestring, [ 1 .. 50 ] charactersrequired

Menu item name.

priceinteger, >= 0required

Price in cents.

photoUrlstring, (uri)read-only

Photo URL of the menu item.

photoTextDescriptionstring or null
Response
{
  "id": "prd_01khr487f7qm7p44xn427m43vb",
  "object": "menuItem",
  "name": "coffee",
  "price": 4000,
  "category": "beverage",
  "createdAt": "2026-02-18T10:20:38.228Z",
  "updatedAt": "2026-02-18T10:20:38.228Z",
  "volume": 600,
  "containsCaffeine": false
}