List agent memories

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns what one of the app's agents remembers, newest first.

An agent saves a memory when it learns something worth keeping. A memory can apply to everyone or to one app user, so it can hold personal data about that user.

You get up to 200 memories, and there's no pagination.

This is limited to 60 requests a minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key, including a read-only one, from anyone with access to the app, viewers included. Workspace API keys are not authorized for it.</Note>

get/api/apps/{app_id}/agent-configs/{name}/memory

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/agent-configs/{name}/memory
  • Auth: HTTP bearer

Path parameters

namestring required

Name of the agent.

app_idstring required

ID of the app whose agents to read.

Response

The agent's memories, newest first.

idstring required

ID of the memory.

app_idstring required

ID of the app.

agent_namestring required

Name of the agent the memory belongs to.

contentstring required

What the agent remembered, in its own words.

scopestring required

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

user_idstring nullable

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

conversation_idstring nullable

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

created_datestring required

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

updated_datestring required

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

Example response

[
  {
    "id": "68a1d2c3e4f5061728394a7d",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "agent_name": "support_agent",
    "content": "Prefers delivery updates by email rather than SMS.",
    "scope": "user",
    "user_id": "68a1d2c3e4f5061728394a6c",
    "conversation_id": "68a1d2c3e4f5061728394a5b",
    "created_date": "2026-01-15T09:31:07",
    "updated_date": "2026-01-15T09:31:07"
  }
]

Changes