---
title: "Edit Menu Item"
method: PATCH
path: "/v3.0/boards/{boardSlug}/blocks/{blockSlug}/items/{itemSlug}/"
tags: ["boards"]
---

# Edit Menu Item

`PATCH /v3.0/boards/{boardSlug}/blocks/{blockSlug}/items/{itemSlug}/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/boards/{boardSlug}/blocks/{blockSlug}/items/{itemSlug}/`
- Auth: none declared. Required headers: `x-api-key`

## Path parameters

- `blockSlug` string, required
- `boardSlug` string, required
- `itemSlug` string, required

## Headers

- `x-api-key` string, required
- `x-workspace` string

## Request body

- PatchedMenuItemUpdateRequest
  - `sub_items` object[]: set if this menu item is a group and contains sub items.
  - `cover_slug` string, nullable
  - `icon` string, nullable: received the slug of the menu item icon, and returns the icon image's link.
  - `slug` string
  - `roles` string[]
  - `teams` string[]
  - `file_slugs` string[]: Send the list of slugs for the files uploaded to the storage service and used in menu item, so the files are attached to the menu item.
  - `blocks` string[]: set if this menu item is supposed to open a set of blocks.
  - `title` string
  - `position` integer
  - `page_title` string, nullable: page title for the page represented by this item.
  - `type` 'block' | 'link' | 'embed' | 'group'
  - `link` string, uri, nullable: the link to which the menu item is set.
  - `description` string, nullable: an optional description on the menu item.
  - `content` object: enter your content here. It should be in json format.
  - `config` object, nullable
  - `color` string, nullable: color of item
  - `workspace_access` 'owner' | 'admin' | 'team_member' | 'guest'
  - `access_settings` object, nullable
  - `copy_info` object, nullable
  - `suspicious` boolean: Shows wether the board contains any suspicious menu items.

## Response `200`

- MenuItemUpdate
  - `cover_url` string
  - `icon` string, nullable: received the slug of the menu item icon, and returns the icon image's link.
  - `created` boolean: shows wether the item was created or only updated.
  - `roles` string[]
  - `teams` string[]
  - `blocks` string[]: set if this menu item is supposed to open a set of blocks.
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `title` string
  - `position` integer
  - `page_title` string, nullable: page title for the page represented by this item.
  - `type` 'block' | 'link' | 'embed' | 'group'
  - `link` string, uri, nullable: the link to which the menu item is set.
  - `description` string, nullable: an optional description on the menu item.
  - `content` object: enter your content here. It should be in json format.
  - `config` object, nullable
  - `color` string, nullable: color of item
  - `workspace_access` 'owner' | 'admin' | 'team_member' | 'guest'
  - `access_settings` object, nullable
  - `copy_info` object, nullable
  - `suspicious` boolean: Shows wether the board contains any suspicious menu items.

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)