列出 Memory 版本

列出指定 Memory Store 下的版本快照。版本按 Store 维度组织，可用 memory_id 过滤为单条 memory 的变更历史。每次对 memory 执行创建、更新、删除都会自动生成一个版本，版本不可修改。 列表不返回 content 字段，需要调用查询 Memory 版本才能读取版本内容。

路径

GET /api/v1/forward/memory_stores/{memory_store_id}/memory_versions

请求头

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

路径参数

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

查询参数

参数	类型	必选	说明
`limit`	integer	否	每页返回数量上限，1..100，默认 20。
`before_id`	string	否	向前翻页游标，与 `after_id` 互斥。
`after_id`	string	否	向后翻页游标，与 `before_id` 互斥。
`memory_id`	string	否	只返回该 memory（`mem_...`）的版本，用于查看单条记忆的变更历史。

示例请求

# 列出 Store 下所有版本
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memory_versions" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

# 只看某条 memory 的变更历史
curl -X GET "https://api.qoder.com/api/v1/forward/memory_stores/memstore_00mc7mukn7lkxr454tjd/memory_versions?memory_id=mem_00mc7mvag5u68kkfvxhy" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

示例响应

HTTP 200 OK

{
  "data": [
    {
      "id": "memver_00mc7mw0t337kbcx5q52",
      "type": "memory_version",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "memory_id": "mem_00mc7mvag5u68kkfvxhy",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 108,
      "content_sha256": "9a4f8d2c1b7e6543210fedcba9876543210fedcba9876543210fedcba987654",
      "operation": "updated",
      "redacted": false,
      "redacted_at": null,
      "created_at": "2026-08-14T11:00:00Z"
    },
    {
      "id": "memver_00mc7mvag5u68lh2y8gwh",
      "type": "memory_version",
      "memory_store_id": "memstore_00mc7mukn7lkxr454tjd",
      "memory_id": "mem_00mc7mvag5u68kkfvxhy",
      "path": "decisions/arch-choice.md",
      "content_size_bytes": 99,
      "content_sha256": "1712de0d497a5aeef2beeccf4fbb7d5a16944975438d0c25447b9c1fba13099a",
      "operation": "created",
      "redacted": false,
      "redacted_at": null,
      "created_at": "2026-08-14T10:00:00Z"
    }
  ],
  "first_id": "memver_00mc7mw0t337kbcx5q52",
  "last_id": "memver_00mc7mvag5u68lh2y8gwh",
  "has_more": false
}

空列表响应

{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

响应字段解释

字段	类型	说明
`data`	array	Memory Version 对象数组，不含 `content`。
`first_id`	string/null	当前页第一条记录 ID。
`last_id`	string/null	当前页最后一条记录 ID。
`has_more`	boolean	是否还有更多记录。

错误码

HTTP	type	触发条件
400	`invalid_request_error`	`limit` 越界，或 `after_id`/`before_id` 同时传入。
401	`authentication_error`	缺少或无效的认证令牌。
403	`permission_error`	当前调用方无权访问该资源。
404	`not_found_error`	Memory Store 不存在或跨用户不可见。
500/502/503	`api_error`	Forward 或依赖服务失败。

​路径

​请求头

​路径参数

​查询参数

​示例请求

​示例响应

​空列表响应

​响应字段解释

​错误码

路径