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

# List Agent Versions

> Paginated version history for an agent, newest first. Every configuration change (agent fields, custom tools, phone numbers, knowledge base links) is recorded automatically with the actor and the changed fields. History remains readable after an agent is deleted; the final version is a `deleted` tombstone holding the full last configuration.



## OpenAPI

````yaml GET /agents/{id}/revisions
openapi: 3.1.0
info:
  title: RevRing Voice AI API
  description: >-
    RevRing Voice AI platform API for managing AI voice agents, phone calls, SIP
    trunks, and analytics. Build intelligent voice applications that can handle
    inbound and outbound phone calls with AI-powered conversational agents.
  version: 1.0.0
  contact:
    name: RevRing Support
    url: https://revring.ai
servers:
  - url: https://api.revring.ai/v1
    description: Production API
security:
  - apiKeyAuth: []
tags:
  - name: Messaging Connections
    description: Connect messaging providers so agents can send text messages
  - name: Messages
    description: Send text messages and read your message log
  - name: Conversations
    description: List and clear managed conversation threads
  - name: SIP Trunks
    description: Manage SIP trunks for connecting agents to the phone network
  - name: Agents
    description: Manage AI voice agents and their configuration
  - name: Agent Folders
    description: Organize agents into folders for dashboard navigation
  - name: Calls
    description: Manage and query phone calls
  - name: Analytics
    description: Get analytics and metrics about your calls
  - name: Knowledge Bases
    description: >-
      Manage knowledge bases and sources for agent retrieval-augmented
      generation
  - name: Test Suites
    description: Manage test suites, test cases, and test runs for agent evaluation
  - name: Voices
    description: Browse the voices available to your organization for agent speech
paths:
  /agents/{id}/revisions:
    parameters:
      - name: id
        in: path
        required: true
        description: Agent ID
        schema:
          type: string
          format: uuid
    get:
      tags:
        - Agents
      summary: List Agent Versions
      description: >-
        Paginated version history for an agent, newest first. Every
        configuration change (agent fields, custom tools, phone numbers,
        knowledge base links) is recorded automatically with the actor and the
        changed fields. History remains readable after an agent is deleted; the
        final version is a `deleted` tombstone holding the full last
        configuration.
      operationId: listAgentRevisions
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: pageSize
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
      responses:
        '200':
          description: Version history
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/AgentRevision'
                  page:
                    type: integer
                  pageSize:
                    type: integer
                  total:
                    type: integer
                  hasNextPage:
                    type: boolean
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '402':
          $ref: '#/components/responses/BillingInactiveError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  schemas:
    AgentRevision:
      type: object
      properties:
        revision:
          type: integer
          description: 1-based version number, counting up per agent
        reason:
          type: string
          description: What produced this version
          enum:
            - created
            - baseline
            - updated
            - duplicated
            - deleted
            - restored
            - custom_tool_created
            - custom_tool_updated
            - custom_tool_deleted
            - phone_number_added
            - phone_number_removed
            - knowledge_base_linked
            - knowledge_base_unlinked
        actorType:
          type: string
          enum:
            - user
            - apiKey
            - system
          description: Who made the change
        actorId:
          type: string
          nullable: true
        actorLabel:
          type: string
          nullable: true
          description: Dashboard user email or API key name
        changedFields:
          type: array
          items:
            type: string
          description: >-
            Agent fields whose value changed vs the previous version. ["*"] for
            the first version.
        createdAt:
          type: string
          format: date-time
  responses:
    UnauthorizedError:
      description: Authentication required or API key invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: unauthorized
    BillingInactiveError:
      description: Subscription inactive or billing issue
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: billing_inactive
    NotFoundError:
      description: Resource not found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: not_found
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Generate API keys from the RevRing
        dashboard.

````