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

ParameterRequiredTypeDescription
memory_store_idYesstringMemory store ID

Query parameters

ParameterRequiredTypeDescription
path_prefixNostringDirectory prefix filter, starting and ending with /, for example /notes/; up to 1024 UTF-8 bytes
depthNo0 / 10 lists all files recursively (default); 1 lists only the current level and returns sub-directories in prefixes
viewNobasic / fullbasic excludes bodies (default); full includes bodies
limitNointegerPage size. basic: 1-100, default 20; full: 1-20
pageNostringPagination 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

FieldTypeDescription
dataarray<object>Array of memories; basic view excludes content
idstringMemory ID, in the format mem_xxx
typestringFixed value: memory
memory_store_idstringID of the memory store that the memory belongs to
pathstringPath within the memory store, starting with /
contentstringBody, UTF-8 text; returned when view=full or in single-item retrieval
content_sha256stringSHA256 hash of the body, usable as an optimistic lock for conditional updates
content_size_bytesintegerUTF-8 byte count of the body
memory_version_idstringCurrent version ID, in the format memver_xxx
created_atstringCreation time, ISO 8601 UTC
updated_atstringLast update time, ISO 8601 UTC
prefixesarray<string>Sub-directory prefixes of the current level when depth=1
next_pagestring | nullCursor for the next page; absent when there is no more data

Error codes

HTTP statusError codeDescription
400invalid_request_errorInvalid parameters, path, limit, or pagination cursor
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