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

# List Superagent conversations

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



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/agents/{agent_id}/conversations
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:
    get:
      summary: List Superagent conversations
      description: >-
        <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. 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>
      operationId: list_conversations_api_agents__agent_id__conversations_get
      parameters:
        - 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: Your conversations with the agent.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SuperagentConversationSummary'
                title: SuperagentConversations
        '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 your API key is read-only.
        '404':
          description: Agent not found.
        '429':
          description: Rate limit exceeded (100 requests per minute).
components:
  schemas:
    SuperagentConversationSummary:
      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'
      type: object
      required:
        - id
        - title
        - metadata
        - created_date
        - updated_date
      title: SuperagentConversationSummary
      description: A Superagent conversation, without its messages.
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.