Get agent conversation

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "68a1d2c3e4f5061728394a5b",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "agent_name": "support_agent",
  "created_by_id": "68a1d2c3e4f5061728394a6c",
  "created_by_email": "jane@acme.com",
  "metadata": {
    "name": "Order #1042 delivery date"
  },
  "messages": [
    {
      "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": 6,
  "credit_count": 1.5,
  "answering": "ai",
  "answering_version": 1,
  "human_until": "2023-11-07T05:31:56Z",
  "escalation_summary": "<string>",
  "created_date": "2026-01-15T09:23:41",
  "updated_date": "2026-01-15T09:31:07"
}

Agents

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.

GET

api

apps

{app_id}

agent-configs

conversations

{conversation_id}

Get agent conversation

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/agent-configs/conversations/{conversation_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "68a1d2c3e4f5061728394a5b",
  "app_id": "6820f3a4e7b91d003c45a1f2",
  "agent_name": "support_agent",
  "created_by_id": "68a1d2c3e4f5061728394a6c",
  "created_by_email": "jane@acme.com",
  "metadata": {
    "name": "Order #1042 delivery date"
  },
  "messages": [
    {
      "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": 6,
  "credit_count": 1.5,
  "answering": "ai",
  "answering_version": 1,
  "human_until": "2023-11-07T05:31:56Z",
  "escalation_summary": "<string>",
  "created_date": "2026-01-15T09:23:41",
  "updated_date": "2026-01-15T09:31:07"
}

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

conversation_id

string

required

ID of the conversation. Get this from List agent conversation users.

app_id

string

required

ID of the app whose agents to read.

Response

The conversation and its most recent messages.

One conversation with one of the app's agents, with its messages.

string

required

ID of the conversation.

Example:

"68a1d2c3e4f5061728394a5b"

app_id

string

required

ID of the app.

Example:

"6820f3a4e7b91d003c45a1f2"

agent_name

string

required

Name of the agent the conversation is with.

Example:

"support_agent"

created_by_id

string | null

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

string | null

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

Metadata · object

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

any[]

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

integer

default:0

Number of messages in the conversation.

Example:

6

credit_count

number

default:0

Credits charged for the agent's replies in the conversation.

Example:

1.5

answering

string

default:ai

Who answers the next customer message: ai (the agent), human (the app owner stepped in or replied from their own WhatsApp Business phone), or escalated (the agent asked for the owner and is waiting).

Example:

"ai"

answering_version

integer

default:1

Version of the answering mode. Send it back as expected_version when changing the mode.

Example:

1

human_until

string<date-time> | null

When a hold taken from the owner's own phone ends and the agent resumes, or null while the owner has stepped in.

escalation_summary

string | null

Why the agent asked for the owner, when it did.

created_date

string<date-time> | null

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

Example:

"2026-01-15T09:23:41"

updated_date

string<date-time> | null

When the conversation was last updated, as a UTC timestamp in ISO 8601 format.

Example:

"2026-01-15T09:31:07"

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Outbound webhooks

Get agent conversation

Authorizations

Path Parameters

Response