---
title: "List agent memories"
method: GET
path: "/api/apps/{app_id}/agent-configs/{name}/memory"
---

# List agent memories

`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

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

## Path parameters

- `name` string, required: Name of the agent.
- `app_id` string, required: ID of the app whose agents to read.

## Response `200`

The agent's memories, newest first.

- AgentMemoryItem[]
  - `id` string, required: ID of the memory.
  - `app_id` string, required: ID of the app.
  - `agent_name` string, required: Name of the agent the memory belongs to.
  - `content` string, required: What the agent remembered, in its own words.
  - `scope` string, 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_id` string, nullable: ID of the app user a `user` memory belongs to, or `null` for a `global` memory.
  - `conversation_id` string, nullable: ID of the conversation the agent saved the memory in, or `null` if it wasn't saved in one.
  - `created_date` string, required: When the memory was saved, as a UTC timestamp in ISO 8601 format.
  - `updated_date` string, required: When the memory was last changed, as a UTC timestamp in ISO 8601 format.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You don't have access to this app, or you used a workspace API key.
- `404`: App not found, or the app has no agent with this name.
- `429`: Too many requests for this app in the last minute from personal API keys in your workspace.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-09-29** `d2b7ac8beb0c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/agent-configs/:name/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/fa29e915c226?raw)