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

# List Superagent memories

`GET /api/agents/{agent_id}/memory`

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

## 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, or your API key is read-only.
- `404` — Agent not found.
- `429` — Rate limit exceeded (100 requests per minute).

## Changes

> 26 revisions in range; 1 not diffed.

- **2026-10-05** `4babe63df3b7` — 1 info
  - endpoint added

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

---

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