删除用户组接口

更新时间:
复制 MD 格式

所需权限

所需权限

资源

Scope

资源服务

用户组管理(管理)

user-groups

admin.v1.user-groups.manage

qwenwork-biz-service

DELETE /api/openapi/v1/user-groups/{groupId}

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。

Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。

请求参数

名称

位置

类型

必填

说明

示例

groupId

path

string · uuid

是

用户组 ID

"<uuid>"

请求示例

将 <BASE_URL> 替换为企业部署的千问办公 API 服务地址,并填写实际参数。示例中的占位值不能直接用于请求。

curl --request DELETE \
  --url '<BASE_URL>/api/openapi/v1/user-groups/<groupId>' \
  --header 'Authorization: Bearer <API_KEY>'

响应状态表

HTTP 状态码

触发条件

响应结构引用

客户端处理建议

204

请求成功

无响应体

确认 HTTP 状态码,不解析正文。

default

未单独列出的认证、授权、校验或依赖错误

见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构

按状态与 code 处理;写操作重试前核实结果及幂等要求。

响应结果

无响应体。HTTP 状态码:204.