Skip to main content
GET
Poll conversation updates
Use this endpoint to track conversation progress after calling POST /conversations/connect. This endpoint returns a single latest status text plus readiness/progress values. We recommend polling every 0.5 seconds and showing a loading state until call_is_ready is true.

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.