Get Memory Version

Updated at:

Reads a specific historical version. For reviewing old content; does not roll back the current memory.

Prerequisites

Endpoint and authentication have been configured. For details, see API overview and authentication.

Endpoint

GET /memory_stores/{memory_store_id}/memory_versions/{memory_version_id}

Path parameters

ParameterRequiredTypeDescription
memory_store_idYesstringMemory store ID
memory_version_idYesstringVersion ID

Request example

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

Response

{
  "id": "memver_xxx",
  "type": "memory_version",
  "memory_store_id": "memstore_xxx",
  "memory_id": "mem_xxx",
  "operation": "modified",
  "path": "/notes/project.md",
  "content": "# Project conventions\nUse the staging environment as the default development environment.\nChanges require additional regression tests.\n",
  "content_sha256": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
  "content_size_bytes": 135,
  "created_at": "2026-09-17T08:30:00Z"
}

Response fields

FieldTypeDescription
idstringVersion ID, in the format memver_xxx
typestringFixed as memory_version
memory_store_idstringID of the memory store it belongs to
memory_idstringID of the corresponding memory
operationcreated / modified / deletedThe operation type that produced this version
pathstringThe path in this version snapshot
contentstringThe content of this version; this field is absent when the content has been redacted
content_sha256stringThe SHA256 hash of this version's content
content_size_bytesintegerThe UTF-8 byte size of this version's content
redacted_atstring | nullThe time when the content was redacted; omitted or null if not redacted
created_atstringThe time this version was produced, in ISO 8601 UTC

Error codes

HTTP status codeError codeDescription
401InvalidApiKeyAPI key missing, incorrect, or expired
403permission_errorInsufficient identity or resource access permissions
404not_found_errorThe resource does not exist or does not belong to the current workspace