v3

latestOpenAPI 3.0.0private2026-07-31264964.3 KB

Read a thread

Read an ask/agent thread back as question / answer rounds.

This is both the poll endpoint for a processing answer (GET /ask returns the threadId to poll) and a general way to read a past conversation: it returns every round's question and answer, without the intermediate events. While the run is still working the response is 202 with status: "processing" — poll again after retryAfterSeconds / the Retry-After header.

get/threads/{threadId}

Path parameters

threadIdstring required

The thread id — from a processing response, or any thread of yours.

Response

Ok

threadIdstring required
status'processing' | 'completed' | 'failed' | 'needs-approval' required
titlestring
retryAfterSecondsnumber double

Set while processing — suggested seconds before polling again.

messagestring

Human-readable hint about the current state.

triageUrlstring

needs-approval: where a human reviews the drafted changes.

pendingApprovalCountnumber double