> ## 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 agent conversation
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Returns one conversation with one of the app's agents, with its most recent messages.
The messages are what the app's user and the agent wrote, so they can hold personal data. They also include what the agent's tools returned.
This is limited to 120 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.
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.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/agent-configs/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/apps/{app_id}/agent-configs/conversations/{conversation_id}:
get:
summary: Get agent conversation
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
Returns one conversation with one of the app's agents, with its most
recent messages.
The messages are what the app's user and the agent wrote, so they can
hold personal data. They also include what the agent's tools returned.
This is limited to 120 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.
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.
operationId: >-
get_conversation_api_apps__app_id__agent_configs_conversations__conversation_id__get
parameters:
- name: conversation_id
in: path
required: true
schema:
type: string
description: >-
ID of the conversation. Get this from [List agent conversation
users](/api-reference/list-agent-conversation-users).
title: Conversation Id
description: >-
ID of the conversation. Get this from [List agent conversation
users](/api-reference/list-agent-conversation-users).
example: 68a1d2c3e4f5061728394a5b
- name: app_id
in: path
required: true
schema:
type: string
description: ID of the app whose agents to read.
title: App Id
description: ID of the app whose agents to read.
example: 6820f3a4e7b91d003c45a1f2
responses:
'200':
description: The conversation and its most recent messages.
content:
application/json:
schema:
$ref: '#/components/schemas/ConversationDetailResponse'
'400':
description: '`conversation_id` isn''t a valid conversation ID.'
'401':
description: Missing or invalid credentials.
'403':
description: You don't have access to this app, or you used a workspace API key.
'404':
description: App not found, or the app has no such conversation.
'429':
description: >-
Too many requests for this app in the last minute from personal API
keys in your workspace.
components:
schemas:
ConversationDetailResponse:
properties:
id:
type: string
title: Id
description: ID of the conversation.
example: 68a1d2c3e4f5061728394a5b
app_id:
type: string
title: App Id
description: ID of the app.
example: 6820f3a4e7b91d003c45a1f2
agent_name:
type: string
title: Agent Name
description: Name of the agent the conversation is with.
example: support_agent
created_by_id:
anyOf:
- type: string
- type: 'null'
title: Created By Id
description: >-
ID of the app user who started the conversation. An anonymous
visitor's conversation carries `anonymous`, `guest`, an empty
string, or `null` instead.
example: 68a1d2c3e4f5061728394a6c
created_by_email:
anyOf:
- type: string
- type: 'null'
title: Created By Email
description: >-
Email of the app user who started the conversation, or `null` for an
anonymous visitor or an app user who no longer exists.
example: jane@acme.com
metadata:
additionalProperties: true
type: object
title: Metadata
description: >-
Free-form data stored with the conversation. It holds whatever the
app set when it created the conversation, plus channel details such
as a WhatsApp user's phone number.
example:
name: 'Order #1042 delivery date'
messages:
items: {}
type: array
title: Messages
description: >-
Up to the 200 most recent messages, oldest first. Each message has a
`role` of `user` or `assistant` and its `content`. An assistant
message also lists the `tool_calls` the agent made and what each one
returned, which can include records from the app's data.
example:
- content: 'When will order #1042 arrive?'
hidden: false
id: 4f1c2a9e-7b3d-4e8a-9c21-5d6f7a8b9c0d
role: user
- content: Your order ships tomorrow and should arrive by Friday.
hidden: false
id: 8a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d
role: assistant
message_count:
type: integer
title: Message Count
description: Number of messages in the conversation.
default: 0
example: 6
credit_count:
type: number
title: Credit Count
description: Credits charged for the agent's replies in the conversation.
default: 0
example: 1.5
created_date:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Created Date
description: >-
When the conversation was created, as a UTC timestamp in ISO 8601
format.
example: '2026-01-15T09:23:41'
updated_date:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Updated Date
description: >-
When the conversation was last updated, as a UTC timestamp in ISO
8601 format.
example: '2026-01-15T09:31:07'
type: object
required:
- id
- app_id
- agent_name
title: ConversationDetailResponse
description: One conversation with one of the app's agents, with its messages.
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````