Skip to main content
Dreams

归档 Dream

归档一个已经结束的 Dream。

POST /api/v1/forward/dreams/{id}/archive 只有 completed、failed 或 canceled 状态的 Dream 可以归档。已归档的 Dream 再次调用此接口会幂等返回当前对象。 归档不会删除 Dream。归档记录默认不出现在列表接口中,可以通过 include_archived=true 查询。

请求头

Header是否必填说明
Authorization是Bearer <PAT 或管理员 SAT>。

路径参数

参数类型是否必填说明
idstring是Dream ID,前缀为 drm_。

示例请求

curl -s -X POST 'https://api.qoder.com/api/v1/forward/dreams/drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9/archive' \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK
{
  "id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "type": "dream",
  "status": "completed",
  "inputs": [{
    "type": "identity_template",
    "identity_id": "idn_019eabc123",
    "template_id": "tmpl_support"
  }],
  "outputs": [{
    "type": "memory_store",
    "memory_store_id": "memstore_019e86b4b10578059435632bb357c5ed",
    "files_touched": ["preferences.md"]
  }],
  "model": { "id": "auto" },
  "instructions": "重点整理用户确认过的长期偏好",
  "usage": {
    "input_tokens": 12500,
    "output_tokens": 3200,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 8000
  },
  "error": null,
  "created_at": "2026-09-15T03:00:00Z",
  "ended_at": "2026-09-15T03:03:42Z",
  "archived_at": "2026-09-15T06:00:00Z"
}

响应字段

字段类型说明
返回值object归档后的 Dream 对象,archived_at 非空。

错误

HTTPType触发条件
400invalid_request_errorid 无效、请求体不为空,或者 Dream 尚未进入终态;error.code 可能为 invalid_dream_id、invalid_request_body 或 dream_not_archivable。
401authentication_error认证信息缺失、无效或已过期。
403permission_error当前令牌不能管理 Dream;Identity SAT 不支持此接口。
404not_found_errorDream 不存在或当前调用方不可见;error.code 为 dream_not_found。
429rate_limit_error请求频率达到限制。
500/502/503api_error服务或内部依赖暂时不可用。

相关