Skip to main content
GET
List agent memories

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

name
string
required

Name of the agent.

app_id
string
required

ID of the app whose agents to read.

Response

The agent's memories, newest first.

id
string
required

ID of the memory.

Example:

"68a1d2c3e4f5061728394a7d"

app_id
string
required

ID of the app.

Example:

"6820f3a4e7b91d003c45a1f2"

agent_name
string
required

Name of the agent the memory belongs to.

Example:

"support_agent"

content
string
required

What the agent remembered, in its own words.

Example:

"Prefers delivery updates by email rather than SMS."

scope
string
required

global for a memory the agent uses with every user, or user for one it uses only with the user in user_id.

Example:

"user"

created_date
string
required

When the memory was saved, as a UTC timestamp in ISO 8601 format.

Example:

"2026-01-15T09:31:07"

updated_date
string
required

When the memory was last changed, as a UTC timestamp in ISO 8601 format.

Example:

"2026-01-15T09:31:07"

user_id
string | null

ID of the app user a user memory belongs to, or null for a global memory.

Example:

"68a1d2c3e4f5061728394a6c"

conversation_id
string | null

ID of the conversation the agent saved the memory in, or null if it wasn't saved in one.

Example:

"68a1d2c3e4f5061728394a5b"