Skip to main content
GET
Poll turn status

Authorizations

Authorization
string
header
required

Use Authorization: Bearer

Path Parameters

project_id
string<uuid>
required

UUID of the project

conversation_id
string<uuid>
required

UUID of the conversation

Response

Current turn state

In-flight turn state returned by the async send_message (202) and poll endpoints for playground and Work-with-Clara conversations.

id
string<uuid>
turn_status
enum<string>

Lifecycle of the current chat turn

Available options:
idle,
running,
failed
turn_error
string

Failure detail when turn_status is failed (empty otherwise)

turn_events
object[]

Accumulated message-level events for the current turn. Each item mirrors a former SSE frame: {type_streaming, payload} where type_streaming is one of streaming_in_progress, streaming_error, streaming_completed, or quick_replies_ready (Clara only).

updated_at
string<date-time>

Last activity timestamp; doubles as the turn staleness heartbeat