Get Superagent conversation
curl --request GET \
--url https://app.base44.com/api/agents/{agent_id}/conversations/{conversation_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.base44.com/api/agents/{agent_id}/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/agents/{agent_id}/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/agents/{agent_id}/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/agents/{agent_id}/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))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/agents/{agent_id}/conversations/{conversation_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/agents/{agent_id}/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": "68a1c2e4f0b9d3002e7a5c11",
"title": "Weekly sales summary",
"metadata": {
"source": "crm-sync"
},
"created_date": "2026-08-01T09:15:00Z",
"updated_date": "2026-08-02T14:30:00Z",
"messages": [
{
"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"
}
]
}API Reference
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.
GET
/
api
/
agents
/
{agent_id}
/
conversations
/
{conversation_id}
Get Superagent conversation
curl --request GET \
--url https://app.base44.com/api/agents/{agent_id}/conversations/{conversation_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.base44.com/api/agents/{agent_id}/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/agents/{agent_id}/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/agents/{agent_id}/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/agents/{agent_id}/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))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/agents/{agent_id}/conversations/{conversation_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/agents/{agent_id}/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": "68a1c2e4f0b9d3002e7a5c11",
"title": "Weekly sales summary",
"metadata": {
"source": "crm-sync"
},
"created_date": "2026-08-01T09:15:00Z",
"updated_date": "2026-08-02T14:30:00Z",
"messages": [
{
"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"
}
]
}Authorizations
Personal access token, sent as Authorization: Bearer <token>.
Path Parameters
ID of the conversation to read. Get it from Create Superagent conversation or List Superagent conversations.
ID of the Superagent. It's the agent's app ID, shown in the agent's developer settings.
Response
The conversation, with its latest messages.
A Superagent conversation with its latest messages.
ID of the conversation.
Example:
"68a1c2e4f0b9d3002e7a5c11"
Title Base44 generates from the conversation, or null until one is generated.
Example:
"Weekly sales summary"
Metadata stored on the conversation, including what you sent to Create Superagent conversation when it created it.
Example:
{ "source": "crm-sync" }
Time the conversation was created, as a UTC timestamp in ISO 8601 format.
Example:
"2026-08-01T09:15:00Z"
Time the conversation last changed, as a UTC timestamp in ISO 8601 format.
Example:
"2026-08-02T14:30:00Z"
The conversation's latest messages, oldest first, up to 200.
Show child attributes
Show child attributes
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" } ]
Was this page helpful?