---
title: "POST /v1/iam/menus"
method: POST
path: "/v1/iam/menus"
tags: ["IAMService"]
---

# POST /v1/iam/menus

`POST /v1/iam/menus`

CreateMenu 创建菜单。code/name 必填，code 唯一；visible 不传时默认为 true。

## Request body

- IamV1CreateMenuRequest
  - `code` string
  - `component` string
  - `external` boolean
  - `icon` string
  - `keepAlive` boolean
  - `name` string
  - `parentId` string
  - `path` string
  - `permCode` string
  - `redirect` string
  - `sortOrder` integer
  - `type` integer — 菜单类型：0/1=目录，2=菜单，3=按钮。
  - `visible` boolean — 不传默认 true；显式传 false 可创建隐藏菜单。

## Response `200`

OK

- IamV1CreateMenuReply
  - `menu` IamV1Menu
    - `children` IamV1Menu[]
    - `code` string — 菜单唯一编码。
    - `component` string — 前端组件路径。
    - `createdAt` string, date-time
    - `external` boolean — 是否外链。
    - `icon` string
    - `id` string
    - `isBuiltin` boolean — 内置菜单。内置菜单禁止删除。
    - `keepAlive` boolean — 是否由前端 keep-alive 缓存。
    - `name` string
    - `parentId` string — 父菜单 ID，0 表示根菜单。
    - `path` string — 前端路由路径。
    - `permCode` string — 关联的权限编码，对应 Permission.code；不为空时必须存在。
    - `redirect` string — 前端路由重定向路径。
    - `sortOrder` integer
    - `status` integer — 状态：1=启用，2=禁用。
    - `type` integer — 菜单类型：1=目录，2=菜单，3=按钮。
    - `updatedAt` string, date-time
    - `visible` boolean — 是否在菜单树中可见。创建时不传默认为 true。

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)