monit-rs Tools API

openapi: 3.2.0
info:
  title: Monit Rs Tools 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 tools 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: Tools
paths:
  /api/v1/tools/openapi-diff:
    post:
      tags:
      - Tools
      summary: Diff two OpenAPI specs and classify every change
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenAPIDiffRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Openapi Diff Api V1 Tools Openapi Diff Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '400':
          description: Neither inline spec nor URL supplied for a side, or a fetched spec was unusable.
        '502':
          description: A spec URL could not be fetched.
      description: Supply each side as inline text (`old_spec`/`new_spec`, JSON or YAML) or as an HTTPS URL (`old_url`/`new_url`). Inline wins if both are given. No account required.
      operationId: postApiV1ToolsOpenapiDiff
      x-operation-id-source: derived
    servers:
    - url: https://monit.rs
      description: Production
  /api/v1/tools/openapi-diff/share:
    post:
      tags:
      - Tools
      summary: Publish a diff result to a shareable URL
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_ShareDiffIn'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Share Openapi Diff Api V1 Tools Openapi Diff Share Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '400':
          description: Invalid request.
        '413':
          description: Payload too large.
      operationId: postApiV1ToolsOpenapiDiffShare
      x-operation-id-source: derived
    servers:
    - url: https://monit.rs
      description: Production
  /api/v1/tools/openapi-diff/share/{slug}:
    get:
      tags:
      - Tools
      summary: Retrieve a previously shared diff result
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          title: Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Get Shared Openapi Diff Api V1 Tools Openapi Diff Share  Slug  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '404':
          description: Not found.
      operationId: getApiV1ToolsOpenapiDiffShareBySlug
      x-operation-id-source: derived
    servers:
    - url: https://monit.rs
      description: Production
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    OpenAPIDiffRequest:
      properties:
        old_spec:
          anyOf:
          - type: string
          - type: 'null'
          title: Old Spec
          description: Inline OpenAPI spec (JSON or YAML).
        new_spec:
          anyOf:
          - type: string
          - type: 'null'
          title: New Spec
          description: Inline OpenAPI spec (JSON or YAML).
        old_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Old Url
          description: HTTPS URL to fetch the old spec from.
        new_url:
          anyOf:
          - type: string
          - type: 'null'
          title: New Url
          description: HTTPS URL to fetch the new spec from.
      type: object
      title: OpenAPIDiffRequest
    _ShareDiffIn:
      properties:
        result:
          additionalProperties: true
          type: object
          title: Result
          description: Output of /openapi-diff verbatim.
      type: object
      required:
      - result
      title: _ShareDiffIn
      description: 'Save a previously-computed diff result for shareable permalink.


        Inputs (old_spec/new_spec) are NOT in this payload — only the

        diff RESULT. The visitor''s specs often contain business-sensitive

        field names that they wouldn''t want indexed. The diff output is

        what would be shown to anyone visiting the share URL anyway.'
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
  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