获取记忆版本

根据 ID 获取单个 Memory version。

GET /v1/memory_stores/{memory_store_id}/versions/{version_id}

获取单个 Memory version 对象。只有 version 未 redacted 且内容可用时，响应才包含 content。

​

请求头

头部	必选	说明
Authorization	是	Bearer <PAT>

​

路径参数

参数	类型	必选	说明
memory_store_id	string	是	Memory Store ID，前缀为 memstore_
version_id	string	是	Memory version ID，前缀为 memver_

​

示例请求

curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/versions/memver_xxx" \
  -H "Authorization: Bearer $QODER_PAT"

​

示例响应

HTTP 200 OK，未 redacted

{
  "id": "memver_019e3bb9cf417d89970ba7f45e728c56",
  "type": "memory_version",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
  "entry_path": "versions/test.md",
  "action": "created",
  "content": "Version 1 content",
  "size": 17,
  "content_sha256": "fe80a065cb120813abf7dfceb4018a53d6eb7140c785181634e019656176c64e",
  "redacted": false,
  "created_at": "2026-05-18T15:34:53.528628Z"
}

HTTP 200 OK，已 redacted

{
  "id": "memver_019e3bb9cf417d89970ba7f45e728c56",
  "type": "memory_version",
  "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
  "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
  "entry_path": "versions/test.md",
  "action": "created",
  "size": 17,
  "content_sha256": "fe80a065cb120813abf7dfceb4018a53d6eb7140c785181634e019656176c64e",
  "redacted": true,
  "redacted_at": "2026-05-18T15:35:13.100297Z",
  "created_at": "2026-05-18T15:34:53.528628Z"
}

​

响应字段

字段	类型	说明
id	string	Memory version ID，前缀为 memver_
type	string	固定值 "memory_version"
store_id	string	所属 Memory Store ID
entry_id	string	Memory entry ID
entry_path	string	记录该 version 时的 entry path
action	string	Version 动作，见 Memory version action
content	string	仅 redacted 为 false 且内容可用时返回
size	integer	版本内容大小，单位 byte
content_sha256	string	版本内容的 SHA-256 摘要
redacted	boolean	版本内容是否已 redact
redacted_at	string	UTC redact 时间，仅 redacted 为 true 时返回
created_at	string	UTC 创建时间

​

错误码

HTTP	type	触发条件
401	authentication_error	缺少或无效的认证令牌
404	not_found_error	指定的 Memory Store 或 version 不存在

完整错误信封说明详见 错误参考。

​

相关

Memory Stores

让 Agent 拥有跨 Session 的持久记忆。