删除角色

POST/web/v1/workspaces/{workspaceId}/roles/{roleId}/delete JWT

删除自定义工作空间角色。该角色必须没有已分配的成员。

鉴权

Auth Chain: WEB Chain — 需要 Authorization: Bearer <jwt> 系统注入的请求头（前端无需处理）：X-PORTAL-ACCESS-CODE（Nginx）、X-Request-Id（Gateway）

请求参数

Name	Type	Required	In	Description
workspaceId	String	Required	path	工作空间业务 ID
roleId	String	Required	path	角色业务 ID

成功响应

状态码: 204 No Content

204 No Content 204

{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2004",
  "message": "NO_CONTENT",
  "data": null
}

错误响应

未授权 401

{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}

冲突 409

{
  "success": false,
  "code": "WORKSPACE.OWNER_ROLE_PROTECTED",
  "message": "OWNER role cannot be deleted"
}

冲突 409

{
  "success": false,
  "code": "WORKSPACE.ROLE_IN_USE",
  "message": "Cannot delete a role that still has members assigned"
}

说明

• 成功时返回 HTTP 204，响应码 "2004"，data: null。
• OWNER 角色不可删除（409 WORKSPACE.OWNER_ROLE_PROTECTED）。
• 有成员分配的角色不可删除（409 WORKSPACE.ROLE_IN_USE），须先通过变更成员角色接口重新分配成员。
• 需要 workspace:role:write 权限。