# List menus

`GET https://api.cademi.com.br/api/v3/menus`

Operation ID: `menus.list` · API v3

Returns the fixed set of menus provided by the platform, including the capabilities and supported item kinds of each menu. Menus cannot be created or deleted.

Reading menus requires the `menu_items.read` permission; there is no separate permission for menus.

Required permissions: `menu_items.read`.

## Responses

### 200

Returns the collection of menus.

Body: `data`: array of Menu.

Fields of Menu:

| Field | Type | Required | Description |
|---|---|---|---|
| `item_kinds` | array of string, one of `shortcut`, `product`, `showcase`, `url`, `embed` | yes |  |
| `key` | string, one of `student-area` | yes |  |
| `label` | string | yes |  |
| `object` | string, one of `menu` | yes |  |
| `sidebar_hidden` | boolean | yes |  |
| `supports_hierarchy` | boolean, one of `false` | yes |  |
| `supports_move` | boolean, one of `false` | 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.

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