List Memories
Updated at:
Lists memory files of a memory store sorted by path, with path-prefix filtering. Keyword search over bodies is not supported.
Prerequisites
Endpoint and authentication configured. For details, see Overview and authentication.
Endpoint
GET /memory_stores/{memory_store_id}/memories
Path parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
memory_store_id | Yes | string | Memory store ID |
Query parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
path_prefix | No | string | Directory prefix filter, starting and ending with /, for example /notes/; up to 1024 UTF-8 bytes |
depth | No | 0 / 1 | 0 lists all files recursively (default); 1 lists only the current level and returns sub-directories in prefixes |
view | No | basic / full | basic excludes bodies (default); full includes bodies |
limit | No | integer | Page size. basic: 1-100, default 20; full: 1-20 |
page | No | string | Pagination cursor. Keep all other query parameters and limit unchanged when paging |
Request example
curl "$AGENTSTUDIO_URL/memory_stores/memstore_xxx/memories" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"
Response
{
"data": [
{
"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"
}
],
"prefixes": [],
"next_page": null
}
Response fields
| Field | Type | Description |
|---|---|---|
data | array<object> | Array of memories; basic view excludes content |
id | string | Memory ID, in the format mem_xxx |
type | string | Fixed value: memory |
memory_store_id | string | ID of the memory store that the memory belongs to |
path | string | Path within the memory store, starting with / |
content | string | Body, UTF-8 text; returned when view=full or in single-item retrieval |
content_sha256 | string | SHA256 hash of the body, usable as an optimistic lock for conditional updates |
content_size_bytes | integer | UTF-8 byte count of the body |
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 |
prefixes | array<string> | Sub-directory prefixes of the current level when depth=1 |
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 |
Is this page helpful?