Passport 文档

DELETE/api/v1/orgs/:orgId/roles/:roleId删除角色

删除组织角色并解除全部成员的该角色授权；所有者内置角色不可删除。

Request

Headers

NameData TypeRequiredDescription
AuthorizationstringYes会话令牌认证，格式 `Bearer <sessionToken>`
 
type RequestHeaders = {
  /** 会话令牌认证，格式 `Bearer <sessionToken>` */
  Authorization: string
}

URL Parameters

Name Data Type Description
orgId string 组织 ID
roleId string 角色 ID

Response

Body

result type: null

HTTP Code

HTTP Status Meaning Notes
200 成功 角色已删除
403 无权操作 需要组织管理权限
409 内置角色 所有者内置角色不可删除

Response Code

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

code Meaning Notes
0 成功 角色已删除
2501 无权操作组织 当前用户不持有组织管理权限
2604 内置角色不可删除 所有者内置角色不可删除

Examples

DELETE /api/v1/orgs/01JD8SRP1N4T8W6XQ5V9XDL2Y7K/roles/01JD8SRR3N6V0X8ZS7X1ZFN4A9M
Authorization: Bearer st_7c1f9e05b28d4a63

{
  "id": "01JD8SSDT8R2T0VO",
  "code": 0,
  "messages": [],
  "result": null
}