Skip to main content
GET
Read a past conversation: messages, tool calls and totals.
Scope: chat:transcripts:read. See API Tokens.

Authorizations

Authorization
string
header
required

CloudThinker token: a personal access token ct_pat_… (fine-grained scopes, created in Settings) or an OAuth access token ct_oat_… (1 hour, from the OAuth flow). Send Authorization: Bearer <token>. Scopes have the form module:resource:read|write; write includes read.

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

conversation_id
string<uuid>
required

Conversation id.

Query Parameters

limit
integer
default:100

Newest messages to return.

Required range: 1 <= x <= 100

Response

OK

A past conversation: messages, tool calls and totals, oldest first.

conversation_id
string<uuid>
required
captured_at
string<date-time>
required
messages
TranscriptMessage · object[]
required
summary
TranscriptSummary · object
required

Totals over the returned messages.

truncated
boolean
required

True when messages, tools or text were cut to fit the response.

older
boolean
required

True when older messages exist.