BAbase44

List Superagent memories

Changed on

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

Lists what a Superagent remembers that applies to you.

The list holds the agent's global memories, which apply to every user, and your own user memories. It returns the 200 most recent, newest first.

<Note>This endpoint accepts a personal API key or personal access token belonging to a user with access to the agent, including a read-only one. Workspace API keys are not accepted.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/agents/{agent_id}/memory

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/agents/{agent_id}/memory
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

ID of the Superagent. It's the agent's app ID, shown in the agent's developer settings.

Response

The memories that apply to you.

idstring required

ID of the memory.

contentstring required

What the agent remembers.

scope'global' | 'user' required

Who the memory applies to. global memories apply to every user of the agent, and user memories only to you.

user_idstring nullable required

ID of the user the memory belongs to when scope is user, or null for a global memory.

conversation_idstring nullable required

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

created_datestring date-time required

Time the memory was created, as a UTC timestamp in ISO 8601 format.

updated_datestring date-time required

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

Example response

[
  {
    "id": "68a1c9b2f0b9d3002e7a5c3d",
    "content": "Prefers weekly reports on Monday mornings.",
    "scope": "user",
    "user_id": "6820f41be7b91d003c45a20a",
    "conversation_id": "68a1c2e4f0b9d3002e7a5c11",
    "created_date": "2026-08-02T14:30:00Z",
    "updated_date": "2026-08-02T14:30:00Z"
  }
]

Changes

  • 32455e516133Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 80287813ab84Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API