Skip to main content
GET
Get a request's Builder conversation
Returns the Builder’s conversation for one synthesis request: the first limit messages (1 to 200, default 100), oldest first. Each item is id, createdAt, role and text. isTruncated is true when later messages were left out, and hasThread is false while the Builder has not started a turn. data.conversation is null when the request has no Builder channel or session. When the Builder session touched source-restricted knowledge, its messages are returned redacted. The conversation is found through the request’s own record: the route takes requestId, never a channel id. requestId must appear exactly once and be non-empty; a missing, repeated or empty requestId, or one that is malformed, unknown or in another workspace, answers 404 resource_missing “Synthesis request not found”. A repeated or invalid limit answers 400. Needs platform:read at the platform scope: a grant that covers only some org units receives 403.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

requestId
string
required

The synthesis request id.

Minimum string length: 1

Query Parameters

limit
integer
default:100

Messages to return, 1-200. Default 100.

Required range: 1 <= x <= 200

Response

The Builder conversation, or null

data
object
required
meta
object
required