帮你快速理解、总结文档立即下载

删除 Agent

最近更新时间:2026-10-29 18:19:32
本文档已由 AI 辅助审校
我的收藏

接口描述

删除 Agent 及其版本、路由配置,删除后不可恢复。
DELETE /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}

输入参数

路径参数

参数
类型
说明
enterpriseId
string
WorkBuddy 企业 ID
agentId
string
等价于请求体字段 AgentId

查询参数

无

请求体

无(GET / DELETE 不带请求体,条件走路径与查询参数)

输出参数

204 无响应体。

示例

输入示例

DELETE /v2/enterprises/{enterpriseId}/managedagent/agents/{agentId}
Authorization: Bearer pt_<YOUR_APP_KEY>

错误码

说明:
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见错误响应与公共错误码。
错误码
说明
FailedOperation.AgentPrivateLinkReclaimFailed
该 Agent 的私有网络接入资源回收失败,Agent 未被删除;请重试,或先关闭私网访问再删除
FailedOperation.RoutingInvalidVersion
路由项必须引用同一 Agent 下未停用的 prod 版本
InternalError.AgentOperationFailed
Agent 操作失败
InvalidParameter.AgentIDRequired
缺少 AgentId
InvalidParameter.InvalidRequestBody
请求体不合法
MissingParameter.UinRequired
公共参数中缺少 Uin
ResourceInUse.AgentIDConflict
Agent ID 冲突
ResourceNotFound.Agent
Agent 不存在
ResourceUnavailable.RuntimeAPIUnavailable
未配置 agentos 运行时 API
UnauthorizedOperation.UnprovisionedTenant
租户未开通,或企业不存在