Skip to main content

卸载内置连接器

千问办公企业旗舰版开发者文档:卸载内置连接器。

认证方式见APP开发者文档 → 认证接入。
  • 模块:技能中心
  • 权限:按当前用户的资源范围校验,不要求管理员权限。
  • 接口:DELETE/api/openapi/app/v1/ai-assets/builtin-connectors/{key}/installations

请求

key 仅允许 dws、lark、wecom。请求体为空,不接受市场条目 ID、组织、用户或适配端参数。
请求头必填说明
If-Match是最近读取的 state_etag,原样携带,不能为星号。
Idempotency-Key是8–128 字符稳定键;响应丢失时保持键与原请求重试。

行为与权限

服务端确定 org/user/qwenwork_web,固定内置身份不可由浏览器伪造。添加、配置、授权和启用检查 connector_publish / DISCOVER、INVOKE 与 connector_use / USE 当前权限。本人可清理已撤权登记,不能操作其他用户。OAuth 登录不授予资源权限。 登记使用 Web 独立状态,source_channel=builtin,不伪造市场条目,不产生市场下载统计。重复添加保留选择;首次添加默认关闭;完整卸载重装默认关闭。卸载撤销当前授权代际,异步清理 Nango;断开同时停用。授权/配置成功仍需启用;can_use 固定 false,沙箱执行另行接入。

响应

200 返回MutationResult,含 state_etag、resource。并发按当前状态版本与授权代际串行化;同键异请求返回 409,旧授权回调不能覆盖新尝试。

WebassetsMutationResult

字段类型必填说明
resourceWebassetsResource是本人资源身份、安装登记及偏好;不包含资源包或凭据。
state_etagstring是当前组织/用户/Web 状态版本;写入时作为 If-Match 原样传入。

WebassetsResource

字段类型必填说明
confirmed_generationstring否恢复后该资源的已确认代际;客户端不得自行设置。
enabledboolean否用户启停选择;false 同样覆盖自动下发资源,不能为 null。
idstring是资源 UUID,不是市场条目 ID。
lifecycle_epochinteger是服务端资源生命周期代际,仅用于控制一致性。
manual_installWebassetsInstallation否手动登记实例;自动资源不因下发而创建该字段。
originstring是org 或 public,沿用目录返回的来源。 可选值:org, public。
resource_typestring是支持 skill、expert_kit 和 connector。 可选值:skill, expert_kit, connector。

WebassetsInstallation

字段类型必填说明
installation_idstring是服务端生成的手动安装实例 UUID;完整卸载后重装生成新实例。
registered_atstring是手动登记时间,RFC 3339。
source_channelstring是登记来源渠道;内置连接器为 builtin。
source_market_item_idstring是来源市场条目标识;内置连接器不对应市场条目,不据此发起市场查询。

错误

状态码说明
400参数、请求体或幂等键无效。
401 / 403身份或业务准入失败。
404内置项不支持 Web、无权限或本人安装不存在。
409操作冲突、托管项不能卸载或授权未完成。
412版本过期,重新查询后提交。
422JSON、请求体或查询参数校验失败。
428缺少 If-Match。
503IAM、数据库或 Nango 不可用;不降级放行。