Skip to main content

Get Memory

Reads a single memory with its body. An archived but undeleted store can still be read; a deleted memory returns 404.

Prerequisites

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

Endpoint

GET /memory_stores/{memory_store_id}/memories/{memory_id}

Path parameters

FieldRequiredTypeDescription
memory_store_idYesstringMemory store ID
memory_idYesstringMemory ID

Request example 

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

Response example 

{
  "id": "mem_xxx",
  "type": "memory",
  "memory_store_id": "memstore_xxx",
  "path": "/notes/project.md",
  "content": "# Project Conventions\nThe default development environment is staging.\n",
  "content_sha256": "e3b0c44b98fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "content_size_bytes": 47,
  "memory_version_id": "memver_xxx",
  "created_at": "2026-09-17T08:00:00Z",
  "updated_at": "2026-09-17T08:00:00Z"
}

Response fields

FieldTypeDescription
idstring
typestring
memory_store_idstring
pathstring
contentstring
content_sha256string
content_size_bytesinteger
memory_version_idstring
created_atstring
updated_atstring

Error codes

HTTP statusError codeDescription
401InvalidApiKeyAPI key missing, invalid, or expired
403permission_errorInsufficient identity or resource access permissions
404not_found_errorResource does not exist or does not belong to the current workspace
Managed Agent API
Flow Agent API
Sandbox API
RAG API
Long-term Memory
ParseX API
Security API
Framework Integration
Application components
More
Assistant API (Deprecated)