产物、归档与删除

获取 Agent 产物的临时下载地址，区分可逆归档和永久删除。

This page has not been translated into English yet. The original Chinese version is shown below.

工作目录跨 Run 延续，因此 artifacts 属于 Agent。先列出产物，再把返回的 path 原样交给下载端点。

下载产物

GET /v1/agents/{id}/artifacts 返回 items，含 path、sizeBytes 和 updatedAt。GET /v1/agents/{id}/artifacts/download?path=... 返回 url 与 expiresAt，URL 为有效期 15 分钟的 S3 presigned URL。

curl --request GET \
  --url 'https://api.cursor.com/v1/agents/bc-00000000-0000-0000-0000-000000000001/artifacts/download?path=artifacts/screenshot.png' \
  -u YOUR_API_KEY:

v1 只接受 artifacts 范围下的相对路径，不接受 v0 的 /opt/cursor/artifacts/... 绝对路径。官方对相对基准的描述与示例略有差异，示例返回 artifacts/screenshot.png；客户端应直接使用列表返回值，避免自行拼接或剥离 artifacts/。

下载 URL 失效时重新请求下载端点，不应把临时 URL 作为长期对象标识。

归档与恢复

方法与路径	行为
`POST /v1/agents/{id}/archive`	可逆归档，仍可读取，恢复前不能新建 Run
`POST /v1/agents/{id}/unarchive`	恢复接收后续 Run
`DELETE /v1/agents/{id}`	永久删除，不可逆

archive 和 unarchive 幂等，资源已处于目标状态时返回 200 且无变化，无需先查询状态再操作。永久删除不能代替归档用于临时隐藏任务。

数据保留还涉及对话、产物与运行快照，完整边界见云端隐私与保留。