DELETE/api/v1/admin/roles/:roleId删除管理角色

删除管理角色并解除全部用户持有;内置角色不可删除。

Request

Headers

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

URL Parameters

Name Data Type Description
roleId string 角色 ID

Response

Body

result type: null

HTTP Code

HTTP Status Meaning Notes
200 成功 角色已删除
409 内置角色 内置角色不可删除

Response Code

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

code Meaning Notes
0 成功 角色已删除,用户持有关系一并解除
2604 内置角色不可删除 内置角色不可删除

Examples

DELETE /api/v1/admin/roles/01JD8STK4N8V1Y9AT8X2AGN5B0R
Authorization: Bearer st_7c1f9e05b28d4a63
{
  "id": "01JD8STN7R1Y4DCD",
  "code": 0,
  "messages": [],
  "result": null
}