Skip to main content
GET
Conversation Run State
Poll this to see whether a turn is live, whether it can take a steer (is_steerable, steer_target) and how many follow-ups are queued (with previews). It is cheap, so it is safe to poll frequently. See the Conversations overview for the full conversation model.

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required
conversation_id
string
required

Response

Successful Response

Snapshot the UI uses to render run/queue/steer affordances.

conversation_id
string
required
is_running
boolean
default:false
is_steerable
boolean
default:false
steer_target
string
default:none
active_child_id
string | null
queue_depth
integer
default:0
queued_messages
GatewayQueuedMessage · object[]
execution_status
string | null
conversation_state
string
default:regular