Skip to main content
GET
Poll conversation updates
Use this endpoint to track setup progress after POST /conversations/connect. It is for the loading screen until the assistant is ready. It is not a live transcript channel — once call_is_ready is true, stop polling. Live captions and speaking state come from the Daily call. The Web SDK polls this (via your local updates route) about every 200ms while joining, then stops. If you call the REST API yourself, poll until call_is_ready is true and then stop. Every 0.5 seconds is fine if you are not using the SDK. If you expose your own updates route to the browser, authenticate it the same way as connect. The SDK sends config.headers on each updates GET.

Response behavior

  • conversation_session_id is the conversation session being tracked.
  • latest_update_text is the latest human-readable setup status.
  • completion_percent is a progress indicator for setup/readiness from 0 to 100.
  • call_is_ready becomes true when the bot and participant are ready.
  • when call_is_ready is true, completion_percent is returned as 100
Example response:

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

conversation_session_id
string<uuid>
required

Conversation session ID returned from the connect endpoint.

Response

Conversation updates fetched successfully

conversation_session_id
string<uuid>
required
call_is_ready
boolean
required

True when bot and participant are ready.

completion_percent
number
required

Progress percentage for setup and readiness (0-100).

latest_update_text
string
required

Human-readable latest status text.