Skip to main content

删除个性化策略组

千问办公企业旗舰版开发者文档:删除个性化策略组。

  • Scope: admin.v1.personalization-policy-groups.manage
  • 接口: DELETE/api/openapi/v1/personalization/policy-groups/{group_id}
仅可删除自定义组。删除后用户重新按优先级匹配。提交当前组织策略管理版本,过期版本返回 409。

公共请求头

适用《通过 API 配置 QwenWork 管理后台》的“认证与请求头”章节:Authorization 必填,X-Request-Id 可选;当前接口所需 Scope 见本页。Idempotency-Key 是否适用及必填性以本页请求参数为准,不能用追踪标识替代幂等键。

请求参数

请求体:必填;Content-Type:application/json。
名称位置类型必填说明示例
group_idpathstring是目标策略组 ID-
expected_revisionbodyinteger · int64 | null是上次读取的组织管理版本-

请求示例

curl --request DELETE \
  --url 'https://example.invalid/api/openapi/v1/personalization/policy-groups/11111111-1111-4111-8111-111111111111' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"expected_revision":2}'

响应状态表

HTTP 状态码触发条件响应结构引用客户端处理建议
200请求成功见本文“响应结果”读取响应
429限流或准入依赖不可用见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构按状态码及错误码处理
503限流或准入依赖不可用见《通过 API 配置 QwenWork 管理后台》的“限流错误”结构按状态码及错误码处理
default其他认证、授权、版本冲突或校验错误见《通过 API 配置 QwenWork 管理后台》的“通用错误”结构按状态码及错误码处理

响应结果

Content-Type: application/json
名称类型必填说明示例
group_idstring是目标策略组 ID-
revisioninteger · int64是当前版本。列表和组详情顶层为组织管理版本,分区内为该分区的发布版本-

响应示例

{
  "revision": 1,
  "group_id": "11111111-1111-4111-8111-111111111111"
}