Skip to main content
GET
Get a chat

Authorizations

Authorization
string
header
required

Workspace API key (wk_). GET endpoints require the Workspace read API scope, POST endpoints the Workspace write API scope.

Path Parameters

agentId
string
required

The agent id.

chatId
string
required

The chat / conversation id to fetch.

Response

Success. Empty result sets are also 200.

One conversation with its full history. Messages are stored provider-native, so read format before parsing body. Credential-shaped fields inside tool calls and results are redacted.

id
string
required
agentId
string
required
createdDate
string
required

ISO 8601 timestamp.

starred
boolean
required
messages
object[]
required
lastActivityDate
string

ISO 8601 timestamp.

shortDesc
string
effort
string
llmModel
string

Model or alias chosen for this chat.

llmResolvedModel
string

The concrete model the alias resolved to on the last run.

creditsTotal
number

Forward-only sum; turns predating the field are not counted.

transport
object

Present only on chats that live in an external channel; absent for portal chats.

{key}
any