monit-rs AI Analyses API

openapi: 3.2.0
info:
  title: Monit Rs AI Analyses API
  version: 2026.08.30
  contact:
    name: monit.rs support
    url: https://monit.rs/contact
    email: support@monit.rs
  license:
    name: Data licensed for direct reuse; see terms
    url: https://monit.rs/terms
  termsOfService: https://monit.rs/terms
  x-logo:
    url: https://monit.rs/logo.png
    backgroundColor: '#0f172a'
    altText: monit.rs
  x-origin:
  - url: https://monit.rs/openapi.yaml
    format: openapi
    version: '3.1'
  x-providerName: monit.rs
  description: 'Operations tagged ai-analyses across 2 of this provider''s published API definitions: api.monit.rs-openapi.json, monit-rs-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://monit.rs
  description: Production
tags:
- name: ai-analyses
paths:
  /api/v1/ai-analyses:
    get:
      tags:
      - ai-analyses
      summary: List AI regression analyses
      description: Read-only. All tiers. AI analyses are auto-generated by the regression pipeline; this endpoint just exposes them via API. Filter by endpoint_id or regression_id.
      security:
      - ApiKeyBearer: []
      - BearerJwt: []
      x-scopes:
      - read:ai-analyses
      parameters:
      - name: endpoint_id
        in: query
        schema:
          type: string
          format: uuid
      - name: regression_id
        in: query
        schema:
          type: string
          format: uuid
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: List of AI analyses.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: Missing read:ai-analyses scope.
      operationId: getApiV1AiAnalyses
      x-operation-id-source: derived
    servers:
    - url: https://monit.rs
      description: Production
  /api/v1/ai-analyses/{analysis_id}:
    get:
      tags:
      - ai-analyses
      summary: Get a single AI analysis
      security:
      - ApiKeyBearer: []
      - BearerJwt: []
      x-scopes:
      - read:ai-analyses
      parameters:
      - name: analysis_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: The analysis.
        '404':
          description: Not found or not owned.
      operationId: getApiV1AiAnalysesByAnalysisId
      x-operation-id-source: derived
    servers:
    - url: https://monit.rs
      description: Production
  /api/v1/ai-analyses/regressions/{regression_id}/regenerate:
    post:
      tags:
      - ai-analyses
      summary: Regenerate AI analysis for a regression (paying tiers only)
      description: 'Triggers a fresh AI analysis for the given regression. **Costs money** — spends AI provider tokens per call. Passes through 5 guardrails: scope, tier (Free rejected), monthly quota (`max_ai_analyses`), provider circuit breaker, and a per-day cap (50/day paid, 500/day enterprise). Distinct error `code` per layer so clients can differentiate.'
      security:
      - ApiKeyBearer: []
      - BearerJwt: []
      x-scopes:
      - write:ai-analyses
      parameters:
      - name: regression_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Regenerated. Response includes tokens_used + quota_remaining_month + quota_remaining_day.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: Missing write:ai-analyses scope OR tier_not_eligible (Free tier).
        '404':
          description: Regression not owned by caller.
        '429':
          description: Monthly quota (ai_quota_exceeded) OR daily cap (regenerate_daily_cap) hit.
        '502':
          description: AI provider returned empty (regeneration_failed).
        '503':
          description: Provider circuit breaker open (provider_unavailable) — retry in ~15min.
      operationId: postApiV1AiAnalysesRegressionsByRegressionIdRegenerate
      x-operation-id-source: derived
    servers:
    - url: https://monit.rs
      description: Production
components:
  parameters:
    LimitParam:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 200
        default: 50
      description: Max items per page.
  securitySchemes:
    ApiKeyBearer:
      type: http
      scheme: bearer
      bearerFormat: mrs_live_*
      description: monit.rs API key (mrs_live_ prefix). Get one at https://monit.rs/settings?tab=api-keys after signing in.
    BearerJwt:
      type: http
      scheme: bearer
      description: Bearer JWT token for authenticated user sessions.
externalDocs:
  description: Full public site + browsable changelog
  url: https://monit.rs/changelog
x-refined-from:
- api.monit.rs-openapi.json
- monit-rs-openapi.json