Sign in

List Superagent memories

<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. 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

Path parameters

agent_idstring required

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

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

Changed in 1 of the 26 revisions of this API.1

Of the 26 revisions, 1 has no diff computed.