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 the textual agent_trace per interaction. Off by default: the trace is internal agent-graph structure, so shipping it only on request keeps a node rename from becoming a breaking 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