Skip to main content

删除 Source file

删除当前工作空间的 Agent API 源文件。

接口

DELETE /agents/file/{file_id} 成功返回 200 和删除信封。删除后再次删除返回 404,使用该源文件写入环境会失败。

路径参数

file_id string (必选)源文件 ID本接口没有请求体和 Query 参数。删除源文件不会删除已经写入环境的副本,也不会删除已发布的 Artifact。如果环境模板引用了该源文件,删除后从该模板创建环境会失败并返回 404 File not found。

请求示例

curl -sS -X DELETE "$BASE_URL/agents/file/file_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "OpenAI-Beta: agents=v1"

响应字段

id string被删除的源文件 IDobject string源文件删除结果对象类型,固定为 file.deleteddeleted boolean是否删除成功,删除成功时为 true

响应示例

{
  "id": "file_xxx",
  "object": "file.deleted",
  "deleted": true
}

错误码

HTTP 状态码错误类型 / 错误码解决方案
401authentication_error / invalid_api_key在请求头携带有效的 Authorization: Bearer $DASHSCOPE_API_KEY
404not_found_error / not_found_error使用当前工作空间中存在的源文件 ID
500server_error / server_error稍后重试;持续失败时提交工单并提供 x-request-id