Developers
Menus8

Retrieve a menu item

GET/menus/{menu_key}/items/{menu_item_id}

Retrieves a menu item by its public ID.

The response includes an ETag representing the current revision. Send this value in the If-Match header when updating the menu item to avoid overwriting a newer version.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

menu_key*string

Key of the menu.

menu_item_id*string

Public ID of the menu item, prefixed with mnu_.

Header Parameters

X-Client-Request-Id?string

Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/menus/string/items/string"
{  "data": {    "destination": {      "embed": "string",      "product_id": "string",      "shortcut": "string",      "showcase_id": "string",      "url": "string"    },    "id": "string",    "kind": "shortcut",    "label": "string",    "object": "menu_item",    "position": 0,    "revision": "string",    "target": "_self",    "visible": true  }}

Reorder menu items PUT

Sets the display order of the menu items. The `ids` array must contain the public ID of every item in the menu, in the desired order. Partial reordering is not supported. If the supplied set does not match, the API returns the `order_set_mismatch` error code and the existing order remains unchanged.

Update a menu item PATCH

Updates a menu item. Fields that are omitted keep their current values. Items cannot be nested or moved to another menu. Send the `ETag` returned by the retrieve operation in the `If-Match` header to avoid overwriting changes made since the item was retrieved.