Content Management API > Menu Item

Create a new menu item

Body parameters

id string Optional

RFC 4122 UUID of menu item expressed in URL-safe base64 format

Example:

"uinr2zfqQLeCo_1O0-ao-Q"

label string Required

The label of the menu item

Example:

"Posts"

external_url null, string Optional

The URL to which the menu item points to

position integer Optional

Ordering index

Example:

open_in_new_tab boolean Optional

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

item_type Optional

Item type associated with the menu item

Type: ResourceLinkage<"item_type">, null

item_type_filter Optional

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

Type: ResourceLinkage<"item_type_filter">, null

parent Optional

Parent menu item

Type: null, ResourceLinkage<"menu_item">

Returns

Returns a resource object of type menu_item

Examples

1
import { buildClient } from "@datocms/cma-client-node";
2

3
async function run() {
4
  const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });
5

6
  const menuItem = await client.menuItems.create({ label: "Posts" });
7

8
  // Check the 'Returned output' tab for the result ☝️
9
  console.log(menuItem);
10
}
11

12
run();

1
{
2
  id: "uinr2zfqQLeCo_1O0-ao-Q",
3
  label: "Posts",
4
  position: 1,
5
  external_url: "",
6
  open_in_new_tab: true,
7
  item_type: { type: "item_type", id: "DxMaW10UQiCmZcuuA-IkkA" },
8
  item_type_filter: { type: "item_type_filter", id: "FF-P5of6Qp-DD2w0xoaa6Q" },
9
  parent: null,
10
  children: [{ type: "menu_item", id: "uinr2zfqQLeCo_1O0-ao-Q" }],
11
}

Did this doc help you?

Need help?

Explore our forum, contact support, or connect with our sales team . You can also chat live with other users in our Slack channel.