DELETE/api/v1/orgs/:orgId/members/:userId/roles/:roleId撤销成员的组织角色

Try it 面板需要启用 JavaScript。

移除成员持有的一个组织角色。

Request

Headers

Name	Data Type	Required	Description
Authorization	string	Yes	会话令牌认证，格式 `Bearer <sessionToken>`

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

URL Parameters

Name	Data Type	Description
orgId	string	组织 ID
userId	string	成员用户 ID
roleId	string	角色 ID

Response

Body

result type: null

HTTP Code

HTTP Status	Meaning	Notes
200	成功	角色已撤销
403	无权操作	需要组织管理权限
404	未持有该角色	该成员不持有此角色

Response Code

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

code	Meaning	Notes
0	成功	角色已撤销
2501	无权操作组织	当前用户不持有组织管理权限
2505	成员不存在	该用户不属于此组织
2603	未持有该角色	该成员不持有此角色

Examples

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

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

Remarks

撤销所有者的内置所有者角色被拒绝（共享码 1005）；所有者身份只能经组织移交或注销变更。