归档 Memory Store

归档一个 active 状态的 Memory Store。归档后 Store 仍可读取，但不能继续创建或更新其中的 memory 条目。 归档前会检查挂载关系：该 Store 只要仍被任意 (identity, template) 挂载，就返回 409。需要先解绑所有挂载再归档。

路径

POST /api/v1/forward/memory_stores/{memory_store_id}/archive

请求头

头部	必选	说明
`Authorization`	是	`Bearer <PAT 或 admin SAT>`

不需要请求体。

路径参数

参数	类型	必选	说明
`memory_store_id`	string	是	Memory Store ID（`memstore_...`）。

示例请求

curl -X POST "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/archive" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK

{
  "id": "memstore_00mc7mukn7lkxr454tjd",
  "type": "memory_store",
  "name": "project-alpha-memory",
  "description": "Alpha 项目的 Agent 知识库",
  "status": "archived",
  "entry_count": 12,
  "total_size": 4096,
  "metadata": {"created_by": "forward", "team": "backend"},
  "system_managed": false,
  "identity_id": null,
  "created_at": "2026-08-14T10:00:00Z",
  "updated_at": "2026-08-14T11:00:00Z",
  "archived_at": "2026-08-14T11:00:00Z",
  "binding_info": {"identity_template_count": 0}
}

响应字段解释

返回归档后的 Memory Store 对象，status 变为 archived，archived_at 被填充。

注意事项

归档系统默认库（system_managed=true）会导致该 (identity, template) 下次创建 Session 时新建一个空的默认库，历史记忆变成孤儿数据。除非确认不再需要这些记忆，否则不要归档系统默认库。

错误码

HTTP	type	触发条件
400	`invalid_request_error`	路径参数非法。
401	`authentication_error`	缺少或无效的认证令牌。
403	`permission_error`	当前调用方无权访问该资源。
404	`not_found_error`	Store 不存在或跨用户不可见。
409	`conflict_error`	Store 已归档，或仍被 `(identity, template)` 挂载。
500/502/503	`api_error`	Forward 或依赖服务失败。

​路径

​请求头

​路径参数

​示例请求

​示例响应

​响应字段解释

​注意事项

​错误码

路径

请求头

路径参数

示例请求

示例响应

响应字段解释

注意事项

错误码