---
title: "List Superagent memories"
method: GET
path: "/api/agents/{agent_id}/memory"
---

# List Superagent memories

`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

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

## Path parameters

- `agent_id` string, required: ID of the Superagent. It's the agent's app ID, shown in the agent's developer settings.

## Response `200`

The memories that apply to you.

- SuperagentMemory[]
  - `id` string, required: ID of the memory.
  - `content` string, 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_id` string, nullable, required: ID of the user the memory belongs to when `scope` is `user`, or `null` for a `global` memory.
  - `conversation_id` string, nullable, required: ID of the conversation the agent created the memory in, or `null` when it wasn't created in one.
  - `created_date` string, date-time, required: Time the memory was created, as a UTC timestamp in ISO 8601 format.
  - `updated_date` string, date-time, required: Time the memory last changed, as a UTC timestamp in ISO 8601 format.

## Other responses

- `400`: `agent_id` belongs to an app that isn't a Superagent.
- `401`: Missing or invalid credentials.
- `403`: You don't have access to this agent.
- `404`: Agent not found.
- `429`: Rate limit exceeded (100 requests per minute).

## Changes

- **2026-10-13** `32455e516133`: 2 info
  - the security scope `read_only` was added to the endpoint's security scheme `PersonalAccessTokenAuth`
  - the security scope `full_access` was removed from the endpoint's security scheme `PersonalAccessTokenAuth`
- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-04** `4babe63df3b7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/agents/:agent_id/memory/get.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/c534f09cf314?raw)