Skip to main content

List user memories

POST 
/api/v1/llm/list-memories

Returns memories in the effective user's scope. This operation has no pagination cursor or category filter. A capped response does not prove that the user has seen every stored record or provide a complete all-records traversal guarantee.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Use remembered preferences in a returning user’s conversation

Request​

Responses​

Memories listed

Schema-valid request illustration; replace example identifiers and confirm operation prerequisites.​

Section ID: DOC-MA-conversations-api-listMemories#example-conversations-listMemories-request

Request example

{
  "limit": 1
}

Guide request for Step 2: Let the user review the stored records. Replace example resource identifiers with your own authorized values.​

Section ID: DOC-MA-conversations-api-listMemories#example-cookbook-managed-agents-memory-knowledge-index-02-request

Request example

{
  "limit": 100
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-MA-conversations-api-listMemories#example-conversations-listMemories-response

Response example

{
  "memories": [
    {
      "id": "example_123",
      "memory": "example",
      "userId": "example_123",
      "agentId": "example_123",
      "appId": "example_123",
      "runId": "example_123",
      "metadata": {},
      "score": 1,
      "createdAt": "2026-09-16T12:00:00Z",
      "updatedAt": "2026-09-16T12:00:00Z"
    }
  ]
}

Document ID: DOC-MA-conversations-api-listMemories. Section identities and revisions.

SectionStable reference
List user memoriesDOC-MA-conversations-api-listMemories#overview
RequestDOC-MA-conversations-api-listMemories#request
ResponsesDOC-MA-conversations-api-listMemories#responses