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

# List agent versions API

> List a Bolna voice agent's versions, newest first, with the live version marked by is_current.

Returns the agent's versions, newest first: every version saved with [Save as new version](https://www.bolna.ai/docs/api-reference/agent/v2/versions/create.md), plus the live version. Each version appears once:

* The live version shows its live save, marked with `is_current: true`.
* Any other version shows its latest save. After you [save edits into a version](https://www.bolna.ai/docs/api-reference/agent/v2/versions/update.md), its `id` here is the new save's `version_id`.

Deleted versions aren't listed. Pages hold up to 50 versions; use `page_number` and `page_size`, and read `has_more` to know whether to fetch the next page.


## OpenAPI

````yaml GET /v2/agent/{agent_id}/versions
openapi: 3.1.0
info:
  title: Bolna API
  description: >-
    Use and leverage Bolna Voice AI using APIs through HTTP requests from any
    language in your applications and workflows.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.bolna.ai
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: SIP trunks
    description: >-
      Bring-your-own-carrier SIP trunks, their gateways, carrier IPs and
      numbers.
paths:
  /v2/agent/{agent_id}/versions:
    get:
      description: >-
        List an agent's versions, newest first: every version saved with Save as
        new version, plus the live one. Each version appears once, as its latest
        save.
      parameters:
        - in: path
          name: agent_id
          required: true
          description: The agent's `id`
          schema:
            type: string
            format: uuid
        - in: query
          name: page_number
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - in: query
          name: page_size
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
      responses:
        '200':
          description: A page of agent versions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentVersionList'
        '404':
          description: Agent not found
          content:
            application/json:
              example:
                message: Agent not found
components:
  schemas:
    AgentVersionList:
      type: object
      properties:
        versions:
          type: array
          items:
            $ref: '#/components/schemas/AgentVersion'
        current_version_id:
          type: string
          format: uuid
          nullable: true
          description: '`id` of the live version'
        total:
          type: integer
          description: Number of versions across all pages
        page_number:
          type: integer
        page_size:
          type: integer
        has_more:
          type: boolean
      example:
        versions:
          - id: 7e775357-d9d3-4c82-a7d7-b7c3346caf79
            version_name: v4
            tags: []
            version_status: saved
            is_current: false
            created_at: '2026-11-05T09:12:44.512000'
            updated_at: '2026-11-05T09:12:44.512000'
          - id: 3f1d2b9a-6c8e-4f0a-9b7d-2e5c4a1f8d60
            version_name: v3
            tags: []
            version_status: published
            is_current: true
            created_at: '2026-11-04T16:40:02.118000'
            updated_at: '2026-11-04T16:40:02.118000'
        current_version_id: 3f1d2b9a-6c8e-4f0a-9b7d-2e5c4a1f8d60
        total: 2
        page_number: 1
        page_size: 20
        has_more: false
    AgentVersion:
      type: object
      description: One version of an agent, as its latest save.
      properties:
        id:
          type: string
          format: uuid
          description: >-
            The version's `id`. Pass it as `agent_version_id` to the version
            endpoints and to `POST /call`.
          example: 7e775357-d9d3-4c82-a7d7-b7c3346caf79
        version_name:
          type: string
          description: >-
            The version's name, unique within the agent. New versions are named
            `v1`, `v2` and so on until you rename them.
          example: v4
        tags:
          type: array
          nullable: true
          items:
            type: string
          example:
            - holiday
        version_status:
          type: string
          enum:
            - saved
            - published
          description: >-
            `saved` if this row is the one created with Save as new version,
            `published` if it is a later save into the version (or a save of the
            live version). Both are usable versions.
        is_current:
          type: boolean
          description: >-
            `true` for the live version, the one calls use unless they pin
            another with `agent_version_id`.
        created_at:
          type: string
          format: date-time
          description: When this save was made
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.