Content Management API > Schema Menu Item
Create a new schema menu item
Body parameters
id string Optional
RFC 4122 UUID of schema menu item expressed in URL-safe base64 format
Example:
"uinr2zfqQLeCo_1O0-ao-Q"
type string Required
Must be exactly "schema_menu_item"
.
JSON API type field
attributes.label null, string Required
The label of the schema menu item (only present when the schema menu item is not linked to an item type)
Example:
"Posts"
attributes.kind enum Required
Indicates if the schema menu item refers to an item type or a modular block
Example:
"item_type"
item_type Optional
modular_block Optional
attributes.position integer Optional
Ordering index
Example:
1
relationships.item_type.data Optional
Item type associated with the menu item
Type:
ResourceLinkage<"item_type">, null
relationships.parent.data Optional
Parent schema menu item
Type:
null, ResourceLinkage<"schema_menu_item">
Returns
Returns a resource object of type schema_menu_item.
Examples
POST https://site-api.datocms.com/schema-menu-items HTTP/1.1Authorization: Bearer YOUR-API-TOKENAccept: application/jsonX-Api-Version: 3Content-Type: application/vnd.api+json
{ "data": { "type": "schema_menu_item", "attributes": { "label": "Posts", "kind": "item_type" } }}
curl -g 'https://site-api.datocms.com/schema-menu-items' \ -X POST \ -H "Authorization: Bearer YOUR-API-TOKEN" \ -H "Accept: application/json" \ -H "X-Api-Version: 3" \ -H "Content-Type: application/vnd.api+json" \ --data-binary '{"data":{"type":"schema_menu_item","attributes":{"label":"Posts","kind":"item_type"}}}'
await fetch("https://site-api.datocms.com/schema-menu-items", { method: "POST", headers: { Authorization: "Bearer YOUR-API-TOKEN", Accept: "application/json", "X-Api-Version": "3", "Content-Type": "application/vnd.api+json", }, body: JSON.stringify({ data: { type: "schema_menu_item", attributes: { label: "Posts", kind: "item_type" }, }, }),});
HTTP/1.1 200 OKContent-Type: application/jsonCache-Control: cache-control: max-age=0, private, must-revalidateX-RateLimit-Limit: 30X-RateLimit-Remaining: 28
{ "data": { "type": "schema_menu_item", "id": "uinr2zfqQLeCo_1O0-ao-Q", "relationships": { "item_type": { "data": { "type": "item_type", "id": "DxMaW10UQiCmZcuuA-IkkA" } }, "parent": { "data": null }, "children": { "data": [ { "type": "schema_menu_item", "id": "uinr2zfqQLeCo_1O0-ao-Q" } ] } }, "attributes": { "label": "Posts", "position": 1, "kind": "item_type" } }}