BAbase44

List Superagent conversations

Changed on

<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 makes sure of. Read its messages with 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>

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

Path parameters

agent_idstring required

ID of the Superagent. It's the agent's app ID, shown in the agent's developer settings.

Response

Your conversations with the agent.

idstring required

ID of the conversation.

titlestring nullable required

Title Base44 generates from the conversation, or null until one is generated.

metadataobject required

Metadata stored on the conversation, including what you sent to Create Superagent conversation when it created it.

created_datestring date-time required

Time the conversation was created, as a UTC timestamp in ISO 8601 format.

updated_datestring date-time required

Time the conversation last changed, as a UTC timestamp in ISO 8601 format.

Example response

[
  {
    "id": "68a1c2e4f0b9d3002e7a5c11",
    "title": "Weekly sales summary",
    "metadata": {
      "source": "crm-sync"
    },
    "created_date": "2026-08-01T09:15:00Z",
    "updated_date": "2026-08-02T14:30:00Z"
  }
]

Changes

  • 32455e516133Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 80287813ab84Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API