Skip to main content
GET
/
conversations
/
{conversation_session_id}
/
updates
Poll conversation updates
curl --request GET \
  --url https://akapulu.com/api/conversations/{conversation_session_id}/updates \
  --header 'Authorization: Bearer <token>'
{
  "conversation_session_id": "7f1e7f76-b38d-4d03-b8f8-2570ce8d4e6d",
  "call_is_ready": false,
  "completion_percent": 63.6,
  "latest_update_text": "bot joined daily room"
}
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: 
{
  "conversation_session_id": "7f1e7f76-b38d-4d03-b8f8-2570ce8d4e6d",
  "call_is_ready": false,
  "completion_percent": 64,
  "latest_update_text": "bot joined daily room"
}

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.