List Memory Versions

Prerequisites

Endpoint and authentication configured. For details, see Overview and authentication.

Endpoint

GET /memory_stores/{memory_store_id}/memory_versions

Path parameters

Field	Required	Type	Description
`memory_store_id`	Yes	string	Memory store ID

Query parameters

Field	Required	Type	Description
`memory_id`	No	string	Only returns versions of this memory; omit to return versions of the whole store
`operation`	No	`created` / `modified` / `deleted`	Filters by the operation that produced the version
`created_at.gte`	No	string	Lower bound of the version creation time (inclusive), ISO 8601 UTC
`created_at.lte`	No	string	Upper bound of the version creation time (inclusive), ISO 8601 UTC
`view`	No	`basic` / `full`	basic excludes bodies (default); full returns unredacted bodies
`limit`	No	integer	Page size. basic: 1-100, default 20; full: 1-20
`page`	No	string	Pagination cursor. Keep all query conditions and limit unchanged when paging

Request example

curl "$AGENTSTUDIO_URL/memory_stores/memstore_xxx/memory_versions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response example

{
  "data": [
    {
      "id": "memver_xxx",
      "type": "memory_version",
      "memory_store_id": "memstore_xxx",
      "memory_id": "mem_xxx",
      "operation": "modified",
      "path": "/notes/project.md",
      "content": "# Project Conventions\nThe default development environment is staging.\nChanges require regression tests.\n",
      "content_sha256": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "content_size_bytes": 68,
      "created_at": "2026-09-17T08:30:00Z"
    }
  ],
  "next_page": null
}

Response fields

Field	Type	Description
`data`	array<object>	Array of versions; bodies are included when view=full and not redacted
`id`	string
`type`	string
`memory_store_id`	string
`memory_id`	string
`operation`	`created` / `modified` / `deleted`
`path`	string
`content`	string
`content_sha256`	string
`content_size_bytes`	integer
`redacted_at`	string \| null
`created_at`	string
`next_page`	string \| null	Cursor for the next page; absent when there is no more data

Error codes

HTTP status	Error code	Description
400	`invalid_request_error`	Invalid parameters, path, limit, or pagination cursor
401	`InvalidApiKey`	API key missing, invalid, or expired
403	`permission_error`	Insufficient identity or resource access permissions
404	`not_found_error`	Resource does not exist or does not belong to the current workspace

​Prerequisites

​Endpoint

​Path parameters

​Query parameters

​Request example

​Response example

​Response fields

​Error codes

Prerequisites

Endpoint

Path parameters

Query parameters

Request example

Response example

Response fields

Error codes