Skip to main content
GET
Get a chat thread
🔒 Admin only. Requires administrator privileges — the authenticated principal (API key, embed JWT, or any bearer token) must belong to a user with the admin role. One chat thread with all of its turns, oldest first. A turn is one prompt and everything the agent did to answer it: the final answer, the tools it called, and each query it ran with its SQL, status, row count and any thumbs-up/down feedback. Query result rows are never included. A prompt, answer or SQL longer than 20,000 characters, or an error longer than 2,000, is cut and ends in …. Chat history export is in preview: when it is not enabled for the account, 404 is returned.

Authorizations

Authorization
string
header
required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

deploymentId
integer
required
chatId
string
required

Response

200 - application/json
chatId
string
required

The thread id, as used in chat URLs and the Chat API.

createdAt
string
required
updatedAt
string
required

When the thread last changed, normally its latest turn.

user
object
required
agentId
integer | null

Null for the Auto agent.

initialContext
string | null

The surface inside the app the thread began on; null when it was not recorded.

source
enum<string> | null

Where the thread was started; null for a source this API does not name.

Available options:
web,
api,
mcp,
slack,
scheduled
title
string | null
turns
object[] | null

Oldest first. Present on a single thread, and on a list with includeTurns=true.