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

# Get online evals versions

> Requires scopes: eval:read



## OpenAPI

````yaml /api-reference/openapi.json get /api/online-evals/monitors/{id}/versions
openapi: 3.1.0
info:
  title: EvalGate API
  version: 3.7.6
  description: EvalGate API. See docs/api-contract.md for stability commitments.
servers:
  - url: https://evalgate.com
    description: Production
  - url: http://localhost:3000
    description: Local
security: []
paths:
  /api/online-evals/monitors/{id}/versions:
    get:
      tags:
        - online evals
      summary: Get online evals versions
      description: 'Requires scopes: eval:read'
      operationId: get_online_evals_monitors_id_versions
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/GetApiOnlineEvalsMonitorsIdVersionsResponse200ApplicationJson
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - bearerAuth:
            - eval:read
components:
  schemas:
    GetApiOnlineEvalsMonitorsIdVersionsResponse200ApplicationJson:
      type: object
      properties:
        versions:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              organizationId:
                $ref: '#/components/schemas/OrganizationId'
              monitorId:
                type: number
              versionNumber:
                type: number
              status:
                type: string
              configHash:
                type: string
              sourceSnapshot:
                type: object
                properties:
                  environment:
                    type: string
                  source:
                    type: string
                  status:
                    type: string
                  nameContains:
                    type: string
                  savedViewId:
                    oneOf:
                      - type: 'null'
                      - type: string
                  savedViewQuery:
                    oneOf:
                      - type: 'null'
                      - type: object
                        properties:
                          version:
                            type: number
                            enum:
                              - 1
                          filters:
                            type: array
                            items:
                              type: object
                              properties:
                                field:
                                  oneOf:
                                    - type: string
                                      enum:
                                        - status
                                    - type: string
                                      enum:
                                        - provenance
                                    - type: string
                                      enum:
                                        - user
                                    - type: string
                                      enum:
                                        - environment
                                    - type: string
                                      enum:
                                        - provider
                                    - type: string
                                      enum:
                                        - session
                                    - type: string
                                      enum:
                                        - duration_ms
                                    - type: string
                                      enum:
                                        - trace_id
                                    - type: string
                                      enum:
                                        - source
                                    - type: string
                                      enum:
                                        - score
                                    - type: string
                                      enum:
                                        - prompt_version
                                    - type: string
                                      enum:
                                        - backend
                                    - type: string
                                      enum:
                                        - cost_usd
                                    - type: string
                                      enum:
                                        - latency_ms
                                    - type: string
                                      enum:
                                        - review_status
                                    - type: string
                                      enum:
                                        - model
                                    - type: string
                                      enum:
                                        - created
                                    - type: string
                                      enum:
                                        - trace_name
                                    - type: string
                                      enum:
                                        - failure_category
                                    - type: string
                                      enum:
                                        - tag
                                    - type: string
                                      enum:
                                        - tool_name
                                    - type: string
                                      enum:
                                        - deployment_version
                                    - type: string
                                      enum:
                                        - tool_error
                                    - type: string
                                      enum:
                                        - tokens
                                    - type: string
                                      enum:
                                        - alert_status
                                operator:
                                  oneOf:
                                    - type: string
                                      enum:
                                        - exists
                                    - type: string
                                      enum:
                                        - in
                                    - type: string
                                      enum:
                                        - gte
                                    - type: string
                                      enum:
                                        - lte
                                    - type: string
                                      enum:
                                        - eq
                                    - type: string
                                      enum:
                                        - neq
                                    - type: string
                                      enum:
                                        - gt
                                    - type: string
                                      enum:
                                        - lt
                                    - type: string
                                      enum:
                                        - contains
                                value:
                                  oneOf:
                                    - type: string
                                    - type: number
                                    - type: boolean
                                      enum:
                                        - false
                                    - type: boolean
                                      enum:
                                        - true
                                    - type: array
                                      items:
                                        type: string
                                    - type: array
                                      items:
                                        type: number
                              additionalProperties: false
                              required:
                                - field
                                - operator
                          freeText:
                            type: string
                          sort:
                            type: array
                            items:
                              type: object
                              properties:
                                field:
                                  oneOf:
                                    - type: string
                                      enum:
                                        - duration_ms
                                    - type: string
                                      enum:
                                        - score
                                    - type: string
                                      enum:
                                        - cost_usd
                                    - type: string
                                      enum:
                                        - latency_ms
                                    - type: string
                                      enum:
                                        - created
                                direction:
                                  oneOf:
                                    - type: string
                                      enum:
                                        - asc
                                    - type: string
                                      enum:
                                        - desc
                              additionalProperties: false
                              required:
                                - field
                                - direction
                        additionalProperties: false
                        required:
                          - version
                          - filters
                          - sort
                  savedViewQueryHash:
                    oneOf:
                      - type: 'null'
                      - type: string
                  deploymentId:
                    oneOf:
                      - type: 'null'
                      - type: string
                  promptVersionId:
                    oneOf:
                      - type: 'null'
                      - type: number
                additionalProperties: false
              samplingSnapshot:
                type: object
                properties:
                  mode:
                    oneOf:
                      - type: string
                        enum:
                          - random
                      - type: string
                        enum:
                          - failure_only
                      - type: string
                        enum:
                          - severity_weighted
                      - type: string
                        enum:
                          - uncertainty_weighted
                      - type: string
                        enum:
                          - adaptive
                  sampleRate:
                    type: number
                  failureOnly:
                    type: boolean
                  maxDailySamples:
                    oneOf:
                      - type: 'null'
                      - type: number
                  severityMultiplier:
                    type: number
                  uncertaintyBoost:
                    type: number
                  adaptiveTargetRate:
                    oneOf:
                      - type: 'null'
                      - type: number
                additionalProperties: false
                required:
                  - mode
                  - sampleRate
                  - failureOnly
                  - maxDailySamples
                  - severityMultiplier
                  - uncertaintyBoost
                  - adaptiveTargetRate
              checksSnapshot:
                type: object
                properties:
                  deterministic:
                    type: boolean
                  llmJudge:
                    type: boolean
                  scorerVersionIds:
                    type: array
                    items:
                      type: number
                  maxLatencyMs:
                    oneOf:
                      - type: 'null'
                      - type: number
                  maxCostUsd:
                    oneOf:
                      - type: 'null'
                      - type: number
                  minimumScore:
                    oneOf:
                      - type: 'null'
                      - type: number
                additionalProperties: false
                required:
                  - deterministic
                  - llmJudge
                  - scorerVersionIds
                  - maxLatencyMs
                  - maxCostUsd
                  - minimumScore
              budgetSnapshot:
                type: object
                properties:
                  maxDailyCostUsd:
                    oneOf:
                      - type: 'null'
                      - type: number
                  maxPerCallCostUsd:
                    oneOf:
                      - type: 'null'
                      - type: number
                  maxDailyModelCalls:
                    oneOf:
                      - type: 'null'
                      - type: number
                  backfillMaxCostUsd:
                    oneOf:
                      - type: 'null'
                      - type: number
                  fallbackBehavior:
                    oneOf:
                      - type: string
                        enum:
                          - deterministic_only
                      - type: string
                        enum:
                          - skip
                      - type: string
                        enum:
                          - fail_closed
                additionalProperties: false
                required:
                  - maxDailyCostUsd
                  - maxPerCallCostUsd
                  - maxDailyModelCalls
                  - backfillMaxCostUsd
                  - fallbackBehavior
              alertSnapshot:
                type: object
                properties:
                  failureRateThreshold:
                    type: number
                  minimumSeverity:
                    oneOf:
                      - type: string
                        enum:
                          - low
                      - type: string
                        enum:
                          - medium
                      - type: string
                        enum:
                          - high
                      - type: string
                        enum:
                          - critical
                  dedupeWindowMinutes:
                    type: number
                  channels:
                    type: array
                    items:
                      oneOf:
                        - type: string
                          enum:
                            - review_queue
                        - type: string
                          enum:
                            - webhook
                        - type: string
                          enum:
                            - in_app
                  activationCostWarningUsd:
                    oneOf:
                      - type: 'null'
                      - type: number
                  activationAlertWarningCount:
                    oneOf:
                      - type: 'null'
                      - type: number
                additionalProperties: false
                required:
                  - failureRateThreshold
                  - minimumSeverity
                  - dedupeWindowMinutes
                  - channels
                  - activationCostWarningUsd
                  - activationAlertWarningCount
              learningSnapshot:
                type: object
                properties:
                  generateCandidates:
                    type: boolean
                  autoCreateReview:
                    type: boolean
                  topicAssignment:
                    type: boolean
                  promotionPolicy:
                    oneOf:
                      - type: string
                        enum:
                          - manual
                      - type: string
                        enum:
                          - review_required
                additionalProperties: false
                required:
                  - generateCandidates
                  - autoCreateReview
                  - topicAssignment
                  - promotionPolicy
              policySnapshot:
                type: object
                additionalProperties:
                  $ref: '#/components/schemas/JsonValue'
              promptVersionId:
                oneOf:
                  - type: 'null'
                  - type: number
              promptSnapshot:
                oneOf:
                  - type: 'null'
                  - type: object
                    properties:
                      artifactId:
                        type: number
                      versionId:
                        type: number
                      contentHash:
                        type: string
                      payloadHash:
                        type: string
                      name:
                        type: string
                    additionalProperties: false
                    required:
                      - artifactId
                      - versionId
                      - contentHash
                      - payloadHash
                      - name
              datasetVersionId:
                oneOf:
                  - type: 'null'
                  - type: string
              datasetSnapshot:
                oneOf:
                  - type: 'null'
                  - type: object
                    properties:
                      datasetId:
                        type: string
                      versionId:
                        type: string
                      versionNumber:
                        type: number
                      contentHash:
                        type: string
                      rowCount:
                        type: number
                    additionalProperties: false
                    required:
                      - datasetId
                      - versionId
                      - versionNumber
                      - contentHash
                      - rowCount
              environment:
                type: string
              seed:
                type: number
              snapshotJson:
                type: object
                properties:
                  schemaVersion:
                    type: string
                    enum:
                      - continuous-eval-v1
                  monitorId:
                    type: number
                  versionNumber:
                    type: number
                  source:
                    type: object
                    properties:
                      environment:
                        type: string
                      source:
                        type: string
                      status:
                        type: string
                      nameContains:
                        type: string
                      savedViewId:
                        oneOf:
                          - type: 'null'
                          - type: string
                      savedViewQuery:
                        oneOf:
                          - type: 'null'
                          - type: object
                            properties:
                              version:
                                type: number
                                enum:
                                  - 1
                              filters:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    field:
                                      oneOf:
                                        - type: string
                                          enum:
                                            - status
                                        - type: string
                                          enum:
                                            - provenance
                                        - type: string
                                          enum:
                                            - user
                                        - type: string
                                          enum:
                                            - environment
                                        - type: string
                                          enum:
                                            - provider
                                        - type: string
                                          enum:
                                            - session
                                        - type: string
                                          enum:
                                            - duration_ms
                                        - type: string
                                          enum:
                                            - trace_id
                                        - type: string
                                          enum:
                                            - source
                                        - type: string
                                          enum:
                                            - score
                                        - type: string
                                          enum:
                                            - prompt_version
                                        - type: string
                                          enum:
                                            - backend
                                        - type: string
                                          enum:
                                            - cost_usd
                                        - type: string
                                          enum:
                                            - latency_ms
                                        - type: string
                                          enum:
                                            - review_status
                                        - type: string
                                          enum:
                                            - model
                                        - type: string
                                          enum:
                                            - created
                                        - type: string
                                          enum:
                                            - trace_name
                                        - type: string
                                          enum:
                                            - failure_category
                                        - type: string
                                          enum:
                                            - tag
                                        - type: string
                                          enum:
                                            - tool_name
                                        - type: string
                                          enum:
                                            - deployment_version
                                        - type: string
                                          enum:
                                            - tool_error
                                        - type: string
                                          enum:
                                            - tokens
                                        - type: string
                                          enum:
                                            - alert_status
                                    operator:
                                      oneOf:
                                        - type: string
                                          enum:
                                            - exists
                                        - type: string
                                          enum:
                                            - in
                                        - type: string
                                          enum:
                                            - gte
                                        - type: string
                                          enum:
                                            - lte
                                        - type: string
                                          enum:
                                            - eq
                                        - type: string
                                          enum:
                                            - neq
                                        - type: string
                                          enum:
                                            - gt
                                        - type: string
                                          enum:
                                            - lt
                                        - type: string
                                          enum:
                                            - contains
                                    value:
                                      oneOf:
                                        - type: string
                                        - type: number
                                        - type: boolean
                                          enum:
                                            - false
                                        - type: boolean
                                          enum:
                                            - true
                                        - type: array
                                          items:
                                            type: string
                                        - type: array
                                          items:
                                            type: number
                                  additionalProperties: false
                                  required:
                                    - field
                                    - operator
                              freeText:
                                type: string
                              sort:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    field:
                                      oneOf:
                                        - type: string
                                          enum:
                                            - duration_ms
                                        - type: string
                                          enum:
                                            - score
                                        - type: string
                                          enum:
                                            - cost_usd
                                        - type: string
                                          enum:
                                            - latency_ms
                                        - type: string
                                          enum:
                                            - created
                                    direction:
                                      oneOf:
                                        - type: string
                                          enum:
                                            - asc
                                        - type: string
                                          enum:
                                            - desc
                                  additionalProperties: false
                                  required:
                                    - field
                                    - direction
                            additionalProperties: false
                            required:
                              - version
                              - filters
                              - sort
                      savedViewQueryHash:
                        oneOf:
                          - type: 'null'
                          - type: string
                      deploymentId:
                        oneOf:
                          - type: 'null'
                          - type: string
                      promptVersionId:
                        oneOf:
                          - type: 'null'
                          - type: number
                    additionalProperties: false
                  sampling:
                    type: object
                    properties:
                      mode:
                        oneOf:
                          - type: string
                            enum:
                              - random
                          - type: string
                            enum:
                              - failure_only
                          - type: string
                            enum:
                              - severity_weighted
                          - type: string
                            enum:
                              - uncertainty_weighted
                          - type: string
                            enum:
                              - adaptive
                      sampleRate:
                        type: number
                      failureOnly:
                        type: boolean
                      maxDailySamples:
                        oneOf:
                          - type: 'null'
                          - type: number
                      severityMultiplier:
                        type: number
                      uncertaintyBoost:
                        type: number
                      adaptiveTargetRate:
                        oneOf:
                          - type: 'null'
                          - type: number
                    additionalProperties: false
                    required:
                      - mode
                      - sampleRate
                      - failureOnly
                      - maxDailySamples
                      - severityMultiplier
                      - uncertaintyBoost
                      - adaptiveTargetRate
                  checks:
                    type: object
                    properties:
                      deterministic:
                        type: boolean
                      llmJudge:
                        type: boolean
                      scorerVersionIds:
                        type: array
                        items:
                          type: number
                      maxLatencyMs:
                        oneOf:
                          - type: 'null'
                          - type: number
                      maxCostUsd:
                        oneOf:
                          - type: 'null'
                          - type: number
                      minimumScore:
                        oneOf:
                          - type: 'null'
                          - type: number
                    additionalProperties: false
                    required:
                      - deterministic
                      - llmJudge
                      - scorerVersionIds
                      - maxLatencyMs
                      - maxCostUsd
                      - minimumScore
                  budget:
                    type: object
                    properties:
                      maxDailyCostUsd:
                        oneOf:
                          - type: 'null'
                          - type: number
                      maxPerCallCostUsd:
                        oneOf:
                          - type: 'null'
                          - type: number
                      maxDailyModelCalls:
                        oneOf:
                          - type: 'null'
                          - type: number
                      backfillMaxCostUsd:
                        oneOf:
                          - type: 'null'
                          - type: number
                      fallbackBehavior:
                        oneOf:
                          - type: string
                            enum:
                              - deterministic_only
                          - type: string
                            enum:
                              - skip
                          - type: string
                            enum:
                              - fail_closed
                    additionalProperties: false
                    required:
                      - maxDailyCostUsd
                      - maxPerCallCostUsd
                      - maxDailyModelCalls
                      - backfillMaxCostUsd
                      - fallbackBehavior
                  alerting:
                    type: object
                    properties:
                      failureRateThreshold:
                        type: number
                      minimumSeverity:
                        oneOf:
                          - type: string
                            enum:
                              - low
                          - type: string
                            enum:
                              - medium
                          - type: string
                            enum:
                              - high
                          - type: string
                            enum:
                              - critical
                      dedupeWindowMinutes:
                        type: number
                      channels:
                        type: array
                        items:
                          oneOf:
                            - type: string
                              enum:
                                - review_queue
                            - type: string
                              enum:
                                - webhook
                            - type: string
                              enum:
                                - in_app
                      activationCostWarningUsd:
                        oneOf:
                          - type: 'null'
                          - type: number
                      activationAlertWarningCount:
                        oneOf:
                          - type: 'null'
                          - type: number
                    additionalProperties: false
                    required:
                      - failureRateThreshold
                      - minimumSeverity
                      - dedupeWindowMinutes
                      - channels
                      - activationCostWarningUsd
                      - activationAlertWarningCount
                  learning:
                    type: object
                    properties:
                      generateCandidates:
                        type: boolean
                      autoCreateReview:
                        type: boolean
                      topicAssignment:
                        type: boolean
                      promotionPolicy:
                        oneOf:
                          - type: string
                            enum:
                              - manual
                          - type: string
                            enum:
                              - review_required
                    additionalProperties: false
                    required:
                      - generateCandidates
                      - autoCreateReview
                      - topicAssignment
                      - promotionPolicy
                  scorers:
                    type: array
                    items:
                      type: object
                      properties:
                        artifactId:
                          type: number
                        versionId:
                          type: number
                        contentHash:
                          type: string
                        name:
                          type: string
                        type:
                          type: string
                        definition:
                          type: object
                          additionalProperties:
                            $ref: '#/components/schemas/JsonValue'
                        calibrationBindingId:
                          oneOf:
                            - type: 'null'
                            - type: string
                        calibrationSetId:
                          oneOf:
                            - type: 'null'
                            - type: string
                        calibrationRunId:
                          oneOf:
                            - type: 'null'
                            - type: string
                        scoreMappingId:
                          oneOf:
                            - type: 'null'
                            - type: string
                        comparabilityStatus:
                          oneOf:
                            - type: string
                              enum:
                                - exact
                            - type: string
                              enum:
                                - calibrated
                            - type: string
                              enum:
                                - not_comparable
                      additionalProperties: false
                      required:
                        - artifactId
                        - versionId
                        - contentHash
                        - name
                        - type
                        - definition
                        - calibrationBindingId
                        - calibrationSetId
                        - calibrationRunId
                        - scoreMappingId
                        - comparabilityStatus
                  prompt:
                    oneOf:
                      - type: 'null'
                      - type: object
                        properties:
                          artifactId:
                            type: number
                          versionId:
                            type: number
                          contentHash:
                            type: string
                          payloadHash:
                            type: string
                          name:
                            type: string
                        additionalProperties: false
                        required:
                          - artifactId
                          - versionId
                          - contentHash
                          - payloadHash
                          - name
                  dataset:
                    oneOf:
                      - type: 'null'
                      - type: object
                        properties:
                          datasetId:
                            type: string
                          versionId:
                            type: string
                          versionNumber:
                            type: number
                          contentHash:
                            type: string
                          rowCount:
                            type: number
                        additionalProperties: false
                        required:
                          - datasetId
                          - versionId
                          - versionNumber
                          - contentHash
                          - rowCount
                  policy:
                    type: object
                    additionalProperties:
                      $ref: '#/components/schemas/JsonValue'
                  environment:
                    type: string
                  seed:
                    type: number
                additionalProperties: false
                required:
                  - schemaVersion
                  - monitorId
                  - versionNumber
                  - source
                  - sampling
                  - checks
                  - budget
                  - alerting
                  - learning
                  - scorers
                  - prompt
                  - dataset
                  - policy
                  - environment
                  - seed
              createdBy:
                type: string
              createdAt:
                type: string
                format: date-time
              activatedBy:
                oneOf:
                  - type: 'null'
                  - type: string
              activatedAt:
                oneOf:
                  - type: 'null'
                  - type: string
                    format: date-time
              retiredAt:
                oneOf:
                  - type: 'null'
                  - type: string
                    format: date-time
            additionalProperties: false
            required:
              - id
              - organizationId
              - monitorId
              - versionNumber
              - status
              - configHash
              - sourceSnapshot
              - samplingSnapshot
              - checksSnapshot
              - budgetSnapshot
              - alertSnapshot
              - learningSnapshot
              - policySnapshot
              - promptVersionId
              - promptSnapshot
              - datasetVersionId
              - datasetSnapshot
              - environment
              - seed
              - snapshotJson
              - createdBy
              - createdAt
              - activatedBy
              - activatedAt
              - retiredAt
      additionalProperties: false
      required:
        - versions
    OrganizationId:
      type: string
      format: uuid
    JsonValue:
      oneOf:
        - type: 'null'
        - type: boolean
        - type: number
        - type: string
        - type: array
          items:
            $ref: '#/components/schemas/JsonValue'
        - type: object
          additionalProperties:
            $ref: '#/components/schemas/JsonValue'
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - UNAUTHORIZED
                - FORBIDDEN
                - NOT_FOUND
                - VALIDATION_ERROR
                - RATE_LIMITED
                - CONFLICT
                - INTERNAL_ERROR
                - SERVICE_UNAVAILABLE
                - QUOTA_EXCEEDED
                - NO_ORG_MEMBERSHIP
                - CROSS_ORG_REFERENCE
                - INCOMPLETE
                - MALFORMED
            message:
              type: string
            details: {}
            requestId:
              type: string
              format: uuid
          required:
            - code
            - message
      required:
        - error
  responses:
    ValidationError:
      description: Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Conflict:
      description: Conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key or Session Token

````