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

# POST /v1/iam/permissions

`POST /v1/iam/permissions`

CreatePermission 创建权限。code/name/module 必填，code 唯一。

## Request body

- IamV1CreatePermissionRequest
  - `action` string
  - `code` string
  - `description` string
  - `module` string
  - `name` string
  - `parentId` string
  - `resource` string

## Response `200`

OK

- IamV1CreatePermissionReply
  - `permission` IamV1Permission
    - `action` string — 操作标识，可自定义，如 read/create/update/delete。
    - `code` string — 权限唯一编码，创建后不可修改。
    - `createdAt` string, date-time
    - `description` string
    - `id` string
    - `isBuiltin` boolean — 内置权限。内置权限禁止更新和删除。
    - `module` string — 模块名称，用于前端分组和筛选，可自定义。
    - `moduleCode` string — 模块英文码（如 permission/settings），由后端按内置模块目录派生， 供前端多语言展示用的稳定 key；自定义模块无对应码时为空串。
    - `name` string
    - `parentId` string — 父权限 ID，0 表示顶级权限分组。
    - `resource` string — 资源标识，可自定义。
    - `updatedAt` string, date-time

---

[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)