Skip to main content
GET
Poll a Thread

Authorizations

x-api-key
string
header
required

Path Parameters

thread_id
string
required

Opaque Thread id.

Pattern: ^[A-Za-z0-9_-]+$

Query Parameters

include_trace
boolean
default:false

Opt in to agent_trace per interaction: a plain-English list of the steps the agent took (the searches it ran, the papers it read). Off by default to keep polls light. It is written for display, so don't parse it; the wording can change.

interaction_id
string | null

Hydrate this interaction instead of the latest.

Response

Successful Response

GET /v1/threads/{thread_id} — the polling half of create-then-poll.

thread_id
string
required
status
enum<string>
required

Overall status, mirroring the latest interaction.

Available options:
running,
idle,
failed
url
string
required

Deep-link to the Thread on consensus.app.

interactions
ThreadInteractionResponse · object[]
required
title
string | null
created_at
string<date-time> | null
last_activity_at
string<date-time> | null