撤销用户/用户组的数字员工使用权限
接口说明
撤销用户或用户组对指定数字员工的使用权限。
业务逻辑：
1. 从 identity 构造 AuthContext
2. 请求体互斥校验：userIds / userGroupIds 二选一
3. 委托 AgentAuthorizationAuthorizedService.revoke_authorization 执行
4. 前置校验：MANAGE 权限 + agent 存在性（由 AuthorizedService 层执行，先鉴权后暴露存在性）
5. 撤销用户直接授权后，用户可能仍通过用户组获得授权
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /openapi/revokeAgentUsers HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
租户 ID，公共参数，缺省时使用调用方默认租户。 |
10000 |
| operatingObjectName |
string |
是 |
数字员工名称。 |
string_value |
| userIds |
array |
否 |
被撤销的用户 ID 列表。 |
1 |
|
string |
否 |
被撤销的用户 ID。 |
1 |
|
| userGroupIds |
array |
否 |
被撤销的用户组 ID 列表（16 位 hex 字符串）。 |
string_value |
|
string |
否 |
被撤销的用户组 ID 。 |
string_value |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
撤销用户/用户组响应体。 |
||
| code |
string |
业务状态码：成功为 200，失败为后端错误码（ERR.* / InvalidParameter.*） |
200 |
| message |
string |
错误描述，成功时为空 |
successful |
| requestId |
string |
请求追踪 ID |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| revokedCount |
integer |
本次成功撤销的记录数 |
1 |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "successful",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"revokedCount": 1
}