Update menu

PUT 
/openapi/2026-01/menus/:id

Update a menu's name and items. Built-in menus only allow a limited set of fields to change.

Request

Path Parameters

id stringrequired

Menu id to update

application/json

Body

Bodyrequired

titlestring

New title. Optional; kept unchanged when omitted

categoryint32

Menu category (custom menu = 3). Optional; 0 or omitted keeps the current value

children object[]
Menu items tree. When provided, it replaces all current items and existing items not included are deleted; omitted keeps the current items; an empty array clears all items
Array [
idint64
ID of an existing item in this menu. When updating, passing it updates that item in place and keeps its ID; otherwise a new item is created. Ignored when creating a menu
titlestring
Menu item title
targetstring
Link target, e.g. _blank opens in a new window
disabledint32
Whether the item is disabled: 1 disabled, 0 enabled
url_obj object
Link of the item; omitted means no link
typestring
Link type, e.g. home, product, collection, page, article, blog, web; unrecognized values are saved as no link (0)
source_idstring
ID of the linked resource (product, collection, page, etc.)
urlstring
Link URL
childrenundefined[]
Child items; can be nested to any depth
]

Example

json

{
  "title": "string",
  "category": 0,
  "children": [
    {
      "id": 0,
      "title": "string",
      "target": "string",
      "disabled": 0,
      "url_obj": {
        "type": "string",
        "source_id": "string",
        "url": "string"
      },
      "children": [
        null
      ]
    }
  ]
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

menu object

Updated menu

idstring

Menu ID

Example

json

{
  "code": "string",
  "message": "string",
  "data": {
    "menu": {
      "id": "string"
    }
  }
}