Show examples in:
Javascript HTTP
Endpoint info
Available examples

Content Management API > Menu Item

Update a menu item

Body parameters

type string Required

Must be exactly "menu_item".

attributes.label string Optional

The label of the menu item

Example: "Posts"
attributes.external_url null, string Optional

The URL to which the menu item points to

attributes.position integer Optional

Ordering index

Example: 1
attributes.open_in_new_tab boolean Optional

Opens link in new tab (to be used together with external_url)

relationships.item_type.data Optional

Item type associated with the menu item

relationships.item_type_filter.data Optional

Item type filter associated with the menu item (to be used together with item_type relationship)

relationships.parent.data Optional

Parent menu item

Returns

Returns a resource object of type menu_item.

Examples

1
PUT https://site-api.datocms.com/menu-items/:menu_item_id HTTP/1.1
2
Authorization: Bearer YOUR-API-TOKEN
3
Accept: application/json
4
X-Api-Version: 3
5
Content-Type: application/vnd.api+json
6
7
{
8
"data": {
9
"type": "menu_item",
10
"id": "uinr2zfqQLeCo_1O0-ao-Q"
11
}
12
}
Terminal window
1
curl -g 'https://site-api.datocms.com/menu-items/:menu_item_id' \
2
-X PUT \
3
-H "Authorization: Bearer YOUR-API-TOKEN" \
4
-H "Accept: application/json" \
5
-H "X-Api-Version: 3" \
6
-H "Content-Type: application/vnd.api+json" \
7
--data-binary '{"data":{"type":"menu_item","id":"uinr2zfqQLeCo_1O0-ao-Q"}}'
1
await fetch("https://site-api.datocms.com/menu-items/:menu_item_id", {
2
method: "PUT",
3
headers: {
4
Authorization: "Bearer YOUR-API-TOKEN",
5
Accept: "application/json",
6
"X-Api-Version": "3",
7
"Content-Type": "application/vnd.api+json",
8
},
9
body: JSON.stringify({
10
data: { type: "menu_item", id: "uinr2zfqQLeCo_1O0-ao-Q" },
11
}),
12
});
1
HTTP/1.1 200 OK
2
Content-Type: application/json
3
Cache-Control: cache-control: max-age=0, private, must-revalidate
4
X-RateLimit-Limit: 30
5
X-RateLimit-Remaining: 28
6
7
{
8
"data": {
9
"type": "menu_item",
10
"id": "uinr2zfqQLeCo_1O0-ao-Q",
11
"relationships": {
12
"item_type": {
13
"data": {
14
"type": "item_type",
15
"id": "DxMaW10UQiCmZcuuA-IkkA"
16
}
17
},
18
"item_type_filter": {
19
"data": {
20
"type": "item_type_filter",
21
"id": "FF-P5of6Qp-DD2w0xoaa6Q"
22
}
23
},
24
"parent": {
25
"data": null
26
},
27
"children": {
28
"data": [
29
{
30
"type": "menu_item",
31
"id": "uinr2zfqQLeCo_1O0-ao-Q"
32
}
33
]
34
}
35
},
36
"attributes": {
37
"label": "Posts",
38
"position": 1,
39
"external_url": "",
40
"open_in_new_tab": true
41
}
42
}
43
}