Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
curl -X GET "https://api.trellis.sh/v1/chats?page=1" \
-H "Authorization: Bearer YOUR_TOKEN"
import requests
response = requests.get(
"https://api.trellis.sh/v1/chats",
params={"page": 1},
headers={"Authorization": "Bearer YOUR_TOKEN"}
)
data = response.json()
chats = data["chats"]
has_more = data["has_more"]
const response = await fetch("https://api.trellis.sh/v1/chats?page=1", {
headers: { Authorization: "Bearer YOUR_TOKEN" },
});
const { chats, total, page, page_size, has_more } = await response.json();
{
"chats": [
{
"id": "9f0ac8f2-7a22-4ec8-a778-b0b1b83a86bb",
"agent_id": "4f531a2a-22c0-4104-a9bf-4c97f29a2e23",
"title": "Revenue Analysis",
"preview": "Show me the monthly revenue trends...",
"timestamp": "2026-01-11T14:30:00Z",
"metadata": {
"source_type": "database"
}
},
{
"id": "2b793f92-95f2-46c4-a50f-e2c7c12c2bec",
"agent_id": null,
"title": "Customer Insights",
"preview": "Which customers have the highest...",
"timestamp": "2026-01-10T10:15:00Z",
"metadata": {
"source_type": "database"
}
}
],
"total": 25,
"page": 1,
"page_size": 20,
"has_more": true
}
Retrieve chats for the authenticated user with pagination
Show Chat object
{agent_id} in the chat WebSocket or REST-turn URL. Legacy chats can return null; clients must fall back to their organization’s configured published agent UUID, verified against List Agents. Do not infer it from display name or is_trellis_default. The server does not backfill the legacy row, so apply the fallback on every load.20).curl -X GET "https://api.trellis.sh/v1/chats?page=1" \
-H "Authorization: Bearer YOUR_TOKEN"
import requests
response = requests.get(
"https://api.trellis.sh/v1/chats",
params={"page": 1},
headers={"Authorization": "Bearer YOUR_TOKEN"}
)
data = response.json()
chats = data["chats"]
has_more = data["has_more"]
const response = await fetch("https://api.trellis.sh/v1/chats?page=1", {
headers: { Authorization: "Bearer YOUR_TOKEN" },
});
const { chats, total, page, page_size, has_more } = await response.json();
{
"chats": [
{
"id": "9f0ac8f2-7a22-4ec8-a778-b0b1b83a86bb",
"agent_id": "4f531a2a-22c0-4104-a9bf-4c97f29a2e23",
"title": "Revenue Analysis",
"preview": "Show me the monthly revenue trends...",
"timestamp": "2026-01-11T14:30:00Z",
"metadata": {
"source_type": "database"
}
},
{
"id": "2b793f92-95f2-46c4-a50f-e2c7c12c2bec",
"agent_id": null,
"title": "Customer Insights",
"preview": "Which customers have the highest...",
"timestamp": "2026-01-10T10:15:00Z",
"metadata": {
"source_type": "database"
}
}
],
"total": 25,
"page": 1,
"page_size": 20,
"has_more": true
}