> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Superagent conversation
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns one of your conversations with a Superagent, with its latest messages.
`messages` holds the 200 most recent messages, oldest first.
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.
The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/agents/{agent_id}/conversations/{conversation_id}
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/agents/{agent_id}/conversations/{conversation_id}:
get:
summary: Get Superagent conversation
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns one of your conversations with a Superagent, with its latest
messages.
`messages` holds the 200 most recent messages, oldest first.
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.
The response includes fields beyond the ones documented here.
Don't rely on undocumented response fields, as they can change at any
time.
operationId: >-
get_conversation_api_agents__agent_id__conversations__conversation_id__get
parameters:
- name: conversation_id
in: path
required: true
schema:
type: string
description: >-
ID of the conversation to read. Get it from [Create Superagent
conversation](/api-reference/create-superagent-conversation) or
[List Superagent
conversations](/api-reference/list-superagent-conversations).
title: Conversation Id
description: >-
ID of the conversation to read. Get it from [Create Superagent
conversation](/api-reference/create-superagent-conversation) or
[List Superagent
conversations](/api-reference/list-superagent-conversations).
example: 68a1c2e4f0b9d3002e7a5c11
- name: agent_id
in: path
required: true
schema:
type: string
description: >-
ID of the Superagent. It's the agent's app ID, shown in the
agent's developer settings.
title: Agent Id
description: >-
ID of the Superagent. It's the agent's app ID, shown in the agent's
developer settings.
example: 6820f3a4e7b91d003c45a1f2
responses:
'200':
description: The conversation, with its latest messages.
content:
application/json:
schema:
$ref: '#/components/schemas/SuperagentConversation'
'400':
description: '`agent_id` belongs to an app that isn''t a Superagent.'
'401':
description: Missing or invalid credentials.
'403':
description: >-
You don't have access to this agent, or the conversation belongs to
another user or another agent.
'404':
description: Agent or conversation not found.
'429':
description: Rate limit exceeded (100 requests per minute).
components:
schemas:
SuperagentConversation:
properties:
id:
type: string
title: Id
description: ID of the conversation.
example: 68a1c2e4f0b9d3002e7a5c11
title:
anyOf:
- type: string
- type: 'null'
title: Title
description: >-
Title Base44 generates from the conversation, or `null` until one is
generated.
example: Weekly sales summary
metadata:
additionalProperties: true
type: object
title: Metadata
description: >-
Metadata stored on the conversation, including what you sent to
[Create Superagent
conversation](/api-reference/create-superagent-conversation) when it
created it.
example:
source: crm-sync
created_date:
type: string
format: date-time
title: Created Date
description: >-
Time the conversation was created, as a UTC timestamp in ISO 8601
format.
example: '2026-08-01T09:15:00Z'
updated_date:
type: string
format: date-time
title: Updated Date
description: >-
Time the conversation last changed, as a UTC timestamp in ISO 8601
format.
example: '2026-08-02T14:30:00Z'
messages:
items:
$ref: '#/components/schemas/SuperagentMessage'
type: array
title: Messages
description: The conversation's latest messages, oldest first, up to 200.
example:
- content: Summarize today's sales.
id: 3f2504e0-4f89-41d3-9a0c-0305e82c3301
metadata:
created_date: '2026-08-02T14:29:51Z'
role: user
- content: Here's a summary of today's sales.
id: 6b8f1c2e-9a4d-4e7b-8c3f-1d2e3f4a5b6c
metadata:
created_date: '2026-08-02T14:30:00Z'
role: assistant
type: object
required:
- id
- title
- metadata
- created_date
- updated_date
- messages
title: SuperagentConversation
description: A Superagent conversation with its latest messages.
SuperagentMessage:
properties:
id:
type: string
title: Id
description: ID of the message.
example: 3f2504e0-4f89-41d3-9a0c-0305e82c3301
role:
type: string
enum:
- user
- assistant
title: Role
description: Who wrote the message. Either `user` or `assistant`.
example: assistant
content:
anyOf:
- type: string
- type: 'null'
title: Content
description: >-
Text of the message, or `null` when the message only carries tool
calls.
example: Here's a summary of today's sales.
file_urls:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: File Urls
description: URLs of files attached to the message, or `null` when it has none.
example:
- https://storage.base44.com/6820f3a4e7b91d003c45a1f2/report.pdf
tool_calls:
anyOf:
- items:
$ref: '#/components/schemas/SuperagentToolCall'
type: array
- type: 'null'
title: Tool Calls
description: >-
Tools the agent called while writing the message, or `null` when it
called none.
example:
- id: toolu_01A09q90qw90lq917835lq9
name: web_search
requires_user_input: false
status: success
metadata:
$ref: '#/components/schemas/SuperagentMessageMetadata'
description: When the message was created.
type: object
required:
- id
- role
- content
- metadata
title: SuperagentMessage
description: A message in a Superagent conversation.
SuperagentToolCall:
properties:
id:
type: string
title: Id
description: ID of the tool call.
example: toolu_01A09q90qw90lq917835lq9
name:
type: string
title: Name
description: Name of the tool the agent called.
example: web_search
status:
type: string
enum:
- running
- success
- error
- stopped
- waiting_for_user_input
title: Status
description: >-
Where the tool call is. One of `running`, `success`, `error`,
`stopped`, or `waiting_for_user_input`.
example: success
requires_user_input:
type: boolean
title: Requires User Input
description: >-
Whether the tool call is waiting for the user to answer or approve
something before the agent continues.
example: false
type: object
required:
- id
- name
- status
- requires_user_input
title: SuperagentToolCall
SuperagentMessageMetadata:
properties:
created_date:
type: string
format: date-time
title: Created Date
description: Time the message was created, as a UTC timestamp in ISO 8601 format.
example: '2026-08-02T14:30:00Z'
type: object
required:
- created_date
title: SuperagentMessageMetadata
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.