跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

GET /v1/memory_stores/{memory_store_id}/versions 获取指定 Memory Store 下所有记忆条目的版本历史记录，按时间倒序排列，支持分页。

​
请求头

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

​
路径参数

参数类型必选说明
memory_store_idstring是Memory Store ID（memstore_ 前缀）

​
查询参数

参数类型必选说明
limitinteger否每页返回数量上限
after_idstring否游标分页：返回此 ID 之后的记录
完整分页规范详见 分页。

​
示例请求

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

# 分页
curl -X GET "https://openapi.qoder.sh/api/v1/cloud/memory_stores/memstore_xxx/versions?limit=2&after_id=memver_xxx" \
  -H "Authorization: Bearer $QODER_PAT"

​
示例响应

HTTP 200 OK 
{
  "data": [
    {
      "id": "memver_019e3bb9e5197b0c816e621050a8394e",
      "type": "memory_version",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "entry_id": "mem_019e3bb9cf417d7dbb11fe9784dbb65c",
      "entry_path": "versions/test.md",
      "action": "updated",
      "size": 27,
      "content_sha256": "ff1328301132f954eeac24cd379ab7f6f5a540573bfe3eb2db3995abe3678210",
      "redacted": false,
      "created_at": "2026-05-18T15:34:59.125612Z"
    },
    {
      "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": false,
      "created_at": "2026-05-18T15:34:53.528628Z"
    },
    {
      "id": "memver_019e3bb9a511741f89f28d5e7efb7844",
      "type": "memory_version",
      "store_id": "memstore_019e3bb93b7074f9a5130d39ddcca90f",
      "entry_id": "mem_019e3bb965a671fca51bde1cf8d87de0",
      "entry_path": "test/note.md",
      "action": "deleted",
      "size": 0,
      "content_sha256": "",
      "redacted": false,
      "created_at": "2026-05-18T15:34:42.707852Z"
    }
  ],
  "first_id": "memver_019e3bb9e5197b0c816e621050a8394e",
  "last_id": "memver_019e3bb9a511741f89f28d5e7efb7844",
  "has_more": false
}

​
响应字段

字段类型说明
dataarrayMemoryVersion 对象数组（不含 content）
first_idstring当前页第一条记录 ID
last_idstring当前页最后一条记录 ID
has_moreboolean是否还有更多数据
列表中单条记录字段：
字段类型说明
idstring版本唯一标识符（memver_ 前缀）
typestring固定值 "memory_version"
store_idstring所属 Store ID
entry_idstring关联的记忆条目 ID
entry_pathstring关联记忆条目的路径
actionstring操作类型："created" / "updated" / "deleted"
sizeint64该版本内容大小（deleted 时为 0）
content_sha256string该版本内容哈希（deleted 时为空）
redactedboolean是否已被遮蔽
redacted_atstring遮蔽时间（仅 redacted=true 时存在）
created_atstring版本创建时间（ISO 8601）

​
错误码

HTTPtype触发条件
401authentication_error未提供或无效的认证令牌
404not_found_error指定的 Memory Store 不存在

​
注意事项

  • 版本记录包含所有记忆条目的变更历史（创建、更新、删除）
  • 列表接口不返回 content 字段
  • 按时间倒序排列（最新操作在前）
  • action: "deleted" 的版本记录中 size 为 0，content_sha256 为空字符串
  • 被 redact 的版本在列表中会显示 redacted: true 和 redacted_at
完整错误信封说明详见 错误参考。