> ## 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.

# Compare Versions

> An agent's calls grouped by the version they ran on (environment and revision), to compare an A/B split. Default period: the last 7 days; at most 90.



## OpenAPI

````yaml GET /analytics/versions
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
  - name: Webhooks
    description: Webhook delivery settings for your organization
  - name: Alerts
    description: Alert rules on call metrics, delivered to a webhook or Slack
paths:
  /analytics/versions:
    get:
      tags:
        - Analytics
      summary: Compare Versions
      description: >-
        An agent's calls grouped by the version they ran on (environment and
        revision), to compare an A/B split. Default period: the last 7 days; at
        most 90.
      operationId: compareVersions
      parameters:
        - name: agentId
          in: query
          required: true
          schema:
            type: string
        - name: from
          in: query
          schema:
            type: string
            format: date-time
        - name: to
          in: query
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: One row per version
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        environment:
                          type: string
                          nullable: true
                          description: null = production
                        agentRevision:
                          type: integer
                          nullable: true
                        calls:
                          type: integer
                        finishedCalls:
                          type: integer
                        failureRate:
                          type: number
                          nullable: true
                          description: Percent of finished calls that failed
                        avgDurationSeconds:
                          type: number
                          nullable: true
                        negativeSentimentRate:
                          type: number
                          nullable: true
                        evaluationPassRate:
                          type: number
                          nullable: true
                          description: Percent of judged calls with no failing criterion
                        criteria:
                          type: object
                          additionalProperties:
                            type: object
                            properties:
                              pass:
                                type: integer
                              fail:
                                type: integer
                              passRate:
                                type: number
                                nullable: true
        '400':
          description: Invalid period
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  responses:
    UnauthorizedError:
      description: Authentication required or API key invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: unauthorized
    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.

````

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