跳转到主要内容
GET /v1/memory_stores/{memory_store_id}/versions 获取指定 Memory Store 下 memory entry 的 version 历史。列表响应不包含 content

请求头

头部必选说明
AuthorizationBearer <PAT>

路径参数

参数类型必选说明
memory_store_idstringMemory Store ID,前缀为 memstore_

查询参数

参数类型必选说明
limitinteger每页返回数量上限。必须为正整数;默认 20,最大 100
after_idstring游标分页:返回此 ID 之后的记录。不能与 before_id 同时传入
before_idstring游标分页:返回此 ID 之前的记录。不能与 after_id 同时传入
entry_idstring仅返回指定 memory entry 的 version 记录
created_at[gte]string仅返回创建时间大于等于此 RFC 3339 时间的记录
created_at[lte]string仅返回创建时间小于等于此 RFC 3339 时间的记录
完整分页规范详见 分页

示例请求

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

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

# 只查看某个 memory entry 的版本
curl -X GET "https://api.qoder.com/api/v1/cloud/memory_stores/memstore_xxx/versions?entry_id=mem_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"
    }
  ],
  "first_id": "memver_019e3bb9e5197b0c816e621050a8394e",
  "last_id": "memver_019e3bb9cf417d89970ba7f45e728c56",
  "has_more": false
}

响应字段

字段类型说明
dataarrayMemory version 对象数组;不包含 content
first_idstring | null当前页第一条记录 ID;data 为空时为 null
last_idstring | null当前页最后一条记录 ID;data 为空时为 null
has_moreboolean是否还有更多记录

分页说明

Memory version 列表按资源 ID 倒序返回。has_moretrue 时,使用 after_id=<last_id> 获取下一页。

错误码

HTTPtype触发条件
400invalid_request_errorlimit 非法、时间格式非法,或同时传入 before_idafter_id
401authentication_error缺少或无效的认证令牌
404not_found_error指定的 Memory Store 不存在
完整错误信封说明详见 错误参考

相关

Memory Stores

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