Memory Store

列出 Memory Version

按条件列出历史版本

GET

/api/v1/agentstudio/memory_stores/{memory_store_id}/memory_versions

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/memory_stores/{memory_store_id}/memory_versions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "id": "memver_xxx",
      "type": "memory_version",
      "memory_store_id": "memstore_xxx",
      "memory_id": "mem_xxx",
      "operation": "modified",
      "path": "/notes/project.md",
      "content": "# 项目约定\n默认开发环境为预发环境。\n变更需要补充回归测试。\n",
      "content_sha256": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "content_size_bytes": 68,
      "created_at": "2026-09-17T08:30:00Z"
    }
  ],
  "next_page": null
}

Authorizations

string

header

required

DashScope API Key

Path Parameters

string

required

记忆库 ID

Query Parameters

string

仅返回该记忆的版本；不传则返回整个记忆库的版本

enum<string>

按产生版本的操作类型过滤

Available options:created,modified,deleted

string

版本产生时间下界（含），ISO 8601 UTC

string

版本产生时间上界（含），ISO 8601 UTC

enum<string>

basic 不含正文（默认）；full 返回未擦除的正文

Available options:basic,full

integer

单页条数。basic 为 1-100 默认 20；full 为 1-20

string

分页游标。翻页时保持全部查询条件与 limit 不变

Response

200-application/json

object[]

版本数组；view=full 且未擦除时包含正文

Show child attributes

string

版本 ID，格式 memver_xxx

string

固定为 memory_version

string

所属记忆库 ID

string

对应的记忆 ID

enum<string>

产生该版本的操作类型

Available options:created,modified,deleted

string

该版本快照中的路径

string

该版本正文；已擦除时不含此字段

string

该版本正文的 SHA256 哈希

integer

该版本正文的 UTF-8 字节数

string | null

正文被擦除的时间；未擦除时省略或为 null

string

版本产生时间，ISO 8601 UTC

string | null

下一页游标；无更多数据时不含该字段

cURL

curl --request GET \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/memory_stores/{memory_store_id}/memory_versions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "data": [
    {
      "id": "memver_xxx",
      "type": "memory_version",
      "memory_store_id": "memstore_xxx",
      "memory_id": "mem_xxx",
      "operation": "modified",
      "path": "/notes/project.md",
      "content": "# 项目约定\n默认开发环境为预发环境。\n变更需要补充回归测试。\n",
      "content_sha256": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "content_size_bytes": 68,
      "created_at": "2026-09-17T08:30:00Z"
    }
  ],
  "next_page": null
}