# Update a menu item

`PATCH https://api.cademi.com.br/api/v3/menus/{menu_key}/items/{menu_item_id}`

Operation ID: `menu_items.update` · API v3

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.

Required permissions: `menu_items.update`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `menu_key` | path | string | yes |  |
| `menu_item_id` | path | string | yes |  |
| `If-Match` | header | string | no |  |

## Request body

Content type: `application/json`.

Schema: object.

## Responses

### 200

Returns the updated menu item.

Body: `data`: MenuItem.

Fields of MenuItem:

| Field | Type | Required | Description |
|---|---|---|---|
| `destination` | object | yes |  |
| `id` | string | yes | Public ID, with the mnu_ prefix. |
| `kind` | string, one of `shortcut`, `product`, `showcase`, `url`, `embed` | yes |  |
| `label` | string | yes |  |
| `object` | string, one of `menu_item` | yes |  |
| `position` | integer | yes |  |
| `revision` | string | yes |  |
| `target` | string, one of `_self`, `_blank` | yes |  |
| `visible` | boolean | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The menu key is not recognized, or the menu item was not found or is not accessible with the current credentials.

Body: Error.

### 412

The menu item has changed since the supplied revision was retrieved.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json