Skip to main content

删除 Artifact

删除单个不可变产物版本,不影响其他版本和环境原文件。

接口

DELETE /agents/sessions/{session_id}/artifacts/{artifact_id} 删除指定的 Artifact 版本。成功返回 200 和删除信封。

路径参数

session_id string (必选)Artifact 所属 Sessionartifact_id string (必选)要删除的 Artifact 版本 ID无请求体。

请求示例

curl -sS -X DELETE \
  "$BASE_URL/agents/sessions/sess_xxx/artifacts/artifact_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "OpenAI-Beta: agents=v1"

响应字段

id string被删除的 Artifact 版本 IDobject stringArtifact 删除结果对象类型,固定为 agent.session.artifact.deleteddeleted boolean是否删除成功,成功为 true删除只移除指定的 Artifact 版本。删除后详情、下载和重复删除返回 404,列表不再出现该版本。删除 Artifact 不等于删除沙箱中的原文件,也不等于删除上传的源文件。

响应示例

{
  "id": "artifact_xxx",
  "object": "agent.session.artifact.deleted",
  "deleted": true
}

错误码

HTTP 状态码错误类型 / 错误码解决方案
404not_found_error / not_found_error使用当前工作空间中存在且未删除的 Artifact ID
错误正文形如 {"error":{"type","code","message","param"}},网关错误可能使用不同结构。