Skip to main content

Update Item By ID

Update an existing menu item — change name, description, image, price, quantity, sides, preferences, schedules, or SKU.

When to Use

Use this endpoint when:

  • Editing an item's details (name, price, photos)
  • Modifying side categories or preference labels
  • Adjusting availability schedules

How to Use

Endpoint
POST/v3/service

Step 1: Get the Item ID

Use the itemId returned by Create Item or Get Items by Category ID.

Step 2: Send the Update Payload

POST with function: "update.item" and the request payload including the changed fields.


Request Parameters

serviceSTRING

alacarte service

Example: "alacarte"

versionSTRING

Currently only support "v1"

Example: "v1"

functionSTRING

Function that provide by alacarte

Example: "update.item"

requestOBJECT

Refer to explanation below

itemIdSTRING

Item ID

Example: "5f698149585d7cc1ae35a395"

categoryIdARRAY

Category ID

Example: ["5eabf31ee0e9cd7b01a3a35e"]

nameSTRING

Item name

Example: "Hainan Chicken Rice"

descriptionSTRING

Item description

Example: "yummz"

imageUrlARRAY

Input your image

Example: []

isAvailableBOOLEAN

Item available

Example: true

priceOBJECT

Item price

amountINTEGER

Amount in cent (min RM 0.10 10 = RM 0.10)

Example: 100

currencyTypeSTRING

Current only support Ringgit Malaysia

Example: "MYR"

quantityINTEGER

Item quantity

Example: 380

sidesARRAY

Side categories

nameSTRING

Side Category name

Example: "Side Category 1"

isAvailableBOOLEAN

Side Category available

Example: true

minChoiceINTEGER

Set minimum choice

Example: 1

maxChoiceINTEGER

Set maximum choice

Example: 3

sideItemsARRAY

Side items

referenceItemIdSTRING

Optional, Item reference ID

Example: "5eaa7b72e0e9cd7b01a3a2b2"

idSTRING

Side Item ID

Example: "5f698149585d7cc1ae35a392"

nameSTRING

Side Item name

Example: "Coke"

priceOBJECT

Side item price

amountINTEGER

Amount in cent

Example: 100

currencyTypeSTRING

Current only support Ringgit Malaysia

Example: "MYR"

isAvailableBOOLEAN

Side Item is available

Example: true

preferencesARRAY

Item preferences

idSTRING

Preferences ID

Example: "5f698149585d7cc1ae35a38d"

nameSTRING

Preferences name

Example: "Sweetness"

minChoiceINTEGER

Set minimum choice

Example: 1

maxChoiceINTEGER

Set maximum choice

Example: 3

labelsARRAY

Preference labels

idSTRING

Label ID

Example: "5f698149585d7cc1ae35a38e"

nameSTRING

Label name

Example: "Basic"

schedulesARRAY

Schedules startAt and endAt

Example: ["2020-09-22T02:00:00.000Z", "2020-09-22T14:00:00.000Z"]

skuSTRING

Item SKU

Example: "fkj31i"

Response Parameters

categoryIdSTRING

Category ID

Example: ""

categoryNameSTRING

Name of Category

Example: ""

createdAtDATETIME

Creation date time

Example: "2020-09-22T04:44:57.950398414Z"

descriptionSTRING

Description of the item

Example: "Describe"

imageUrlARRAY

Item image

Example: []

isAvailableBOOLEAN

Item available

Example: true

itemIdSTRING

Item ID

Example: "5f698149585d7cc1ae35a391"

nameSTRING

Item name

Example: "Test123"

positionINTEGER

Current position among item

Example: 2

preferencesARRAY

Item preferences

idSTRING

Preferences ID

Example: "5f698149585d7cc1ae35a38d"

nameSTRING

Preferences name

Example: "Sweetness"

minChoiceINTEGER

Set minimum choice

Example: 1

maxChoiceINTEGER

Set maximum choice

Example: 3

labelsARRAY

Preference labels

idSTRING

Label ID

Example: "5f698149585d7cc1ae35a38e"

nameSTRING

Label name

Example: "Basic"

priceOBJECT

Item price

amountINTEGER

Amount in cent (min RM 0.10 10 = RM 0.10)

Example: 100

currencyTypeSTRING

Current only support Ringgit Malaysia

Example: "MYR"

quantityINTEGER

Item quantity

Example: 350

schedulesARRAY

Schedules startAt and endAt

Example: ["2020-09-22T02:00:00.000Z", "2020-09-22T14:00:00.000Z"]

sidesARRAY

Item sides

idSTRING

Side Category ID

Example: "5f698149585d7cc1ae35a395"

nameSTRING

Side Category name

Example: "Side Category 1"

isAvailableBOOLEAN

Side Category available

Example: true

minChoiceINTEGER

Set minimum choice

Example: 1

maxChoiceINTEGER

Set maximum choice

Example: 3

sideItemsARRAY

Side items

referenceItemIdSTRING

Optional, Item reference ID

Example: "5eaa7b72e0e9cd7b01a3a2b2"

idSTRING

Side Item ID

Example: "5f698149585d7cc1ae35a392"

nameSTRING

Side Item name

Example: "Coke"

priceOBJECT

Side item price

amountINTEGER

Amount in cent (min RM 0.10 10 = RM 0.10)

Example: 100

currencyTypeSTRING

Current only support Ringgit Malaysia

Example: "MYR"

isAvailableBOOLEAN

Side Item is available

Example: true

skuSTRING

Item SKU

Example: "fkj31i"

updatedAtDATETIME

Last update date time

Example: "2020-09-22T04:44:57.950398414Z"