> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akapulu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Poll Conversation Updates

> Fetch current conversation readiness and progress for a conversation session.

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:

```json theme={null}
{
  "conversation_session_id": "7f1e7f76-b38d-4d03-b8f8-2570ce8d4e6d",
  "call_is_ready": false,
  "completion_percent": 64,
  "latest_update_text": "bot joined daily room"
}
```


## OpenAPI

````yaml openapi/akapulu.json GET /conversations/{conversation_session_id}/updates
openapi: 3.1.0
info:
  title: Akapulu Labs API
  version: 1.0.0
  description: Public Akapulu Labs API reference.
servers:
  - url: https://akapulu.com/api
security:
  - bearerAuth: []
paths:
  /conversations/{conversation_session_id}/updates:
    get:
      summary: Poll conversation updates
      description: >-
        Fetch current conversation readiness and progress for a conversation
        session.
      parameters:
        - name: conversation_session_id
          in: path
          required: true
          description: Conversation session ID returned from the connect endpoint.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Conversation updates fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationUpdatesResponse'
              examples:
                success:
                  value:
                    conversation_session_id: 7f1e7f76-b38d-4d03-b8f8-2570ce8d4e6d
                    call_is_ready: false
                    completion_percent: 63.6
                    latest_update_text: bot joined daily room
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              examples:
                invalid_key:
                  value:
                    error: Invalid API key
        '404':
          description: Conversation session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              examples:
                missing_session:
                  value:
                    error: ConversationSession not found
components:
  schemas:
    ConversationUpdatesResponse:
      type: object
      required:
        - conversation_session_id
        - call_is_ready
        - completion_percent
        - latest_update_text
      properties:
        conversation_session_id:
          type: string
          format: uuid
        call_is_ready:
          type: boolean
          description: True when bot and participant are ready.
        completion_percent:
          type: number
          description: Progress percentage for setup and readiness (0-100).
        latest_update_text:
          type: string
          description: Human-readable latest status text.
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````