Get Memory
Updated at:
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 have been configured. For details, see API overview and authentication.
Endpoint
GET /memory_stores/{memory_store_id}/memories/{memory_id}
Path parameters
| Field | Required | Type | Description |
|---|---|---|---|
memory_store_id | Yes | string | Memory store ID |
memory_id | Yes | string | Memory ID |
Request example
curl "$AGENTSTUDIO_URL/memory_stores/memstore_xxx/memories/mem_xxx" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"
Response
{
"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
| Field | Type | Description |
|---|---|---|
id | string | Memory ID, in the format mem_xxx |
type | string | Fixed value: memory |
memory_store_id | string | ID of the memory store the memory belongs to |
path | string | Path within the memory store, starting with / |
content | string | Body content, UTF-8 text; returned when view=full or when reading a single memory |
content_sha256 | string | SHA256 hash of the body content, usable as an optimistic lock for conditional updates |
content_size_bytes | integer | Size of the body content in UTF-8 bytes |
memory_version_id | string | Current version ID, in the format memver_xxx |
created_at | string | Creation time, ISO 8601 UTC |
updated_at | string | Last update time, ISO 8601 UTC |
Error codes
| HTTP status | Error code | Description |
|---|---|---|
| 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 |
Is this page helpful?