NATSpermission.role.create创建角色

Try it 面板需要启用 JavaScript。

创建组织角色或管理角色；权限标识必须存在于定义目录。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
scope	string	Yes	org / admin
orgId	string	No	scope=org 时的组织 ID
name	string	Yes	角色名
description	string	No	角色描述
permissions	array	Yes	权限标识列表

type RequestBody = {
  /** org / admin */
  scope: string
  /** scope=org 时的组织 ID */
  orgId?: string
  /** 角色名 */
  name: string
  /** 角色描述 */
  description?: string
  /** 权限标识列表 */
  permissions: string[]
}

{
  "scope": "org",
  "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K",
  "name": "开发",
  "description": "研发团队成员",
  "permissions": [
    "repo:read",
    "repo:write",
    "ci:trigger"
  ]
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

Name	Data Type	Required	Description
roleId	string	Yes	角色 ID
name	string	Yes	角色名
permissions	array	Yes	权限标识列表
createdAt	string	Yes	创建时间

type ResponseBody = {
  /** 角色 ID */
  roleId: string
  /** 角色名 */
  name: string
  /** 权限标识列表 */
  permissions: string[]
  /** 创建时间 */
  createdAt: string
}

{
  "roleId": "01JD8SRR3N6V0X8ZS7X1ZFN4A9M",
  "name": "开发",
  "permissions": [
    "repo:read",
    "repo:write",
    "ci:trigger"
  ],
  "createdAt": "2026-09-03T07:00:00Z"
}

Response Code

回复使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	创建角色
2601	角色名已存在
2602	权限标识无效

Examples

{
  "scope": "org",
  "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K",
  "name": "开发",
  "description": "研发团队成员",
  "permissions": ["repo:read", "repo:write", "ci:trigger"]
}

{
  "id": "01JD8SWBPA9C6DZ",
  "code": 0,
  "messages": [],
  "result": {
    "roleId": "01JD8SRR3N6V0X8ZS7X1ZFN4A9M",
    "name": "开发",
    "permissions": ["repo:read", "repo:write", "ci:trigger"],
    "createdAt": "2026-09-03T07:00:00Z"
  }
}