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

# List Superagent conversations

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

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/agents/{agent_id}/conversations`
- 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 your conversations with a Superagent.

The list holds at most one conversation, your main conversation with the agent. If you own the agent, it's the conversation you chat in inside Base44. The list is empty until that conversation exists, which [Create Superagent conversation](/api-reference/create-superagent-conversation) makes sure of. Read its messages with [Get Superagent conversation](/api-reference/get-superagent-conversation).

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

Your conversations with the agent.

- SuperagentConversationSummary[]
  - `id` string, required: ID of the conversation.
  - `title` string, nullable, required: Title Base44 generates from the conversation, or `null` until one is generated.
  - `metadata` object, required: Metadata stored on the conversation, including what you sent to [Create Superagent conversation](/api-reference/create-superagent-conversation) when it created it.
  - `created_date` string, date-time, required: Time the conversation was created, as a UTC timestamp in ISO 8601 format.
  - `updated_date` string, date-time, required: Time the conversation 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/conversations/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)