ApiGuard — OpenAPI Breaking Change Detector

Detect breaking changes in your API specs before they reach production.

ApiGuard compares two OpenAPI 3.x specifications and identifies every breaking change, non-breaking change, and deprecation — with severity levels, rule IDs, and CI-ready output.

pip install kryptorious-apiguard

Quick Start

# Compare two specs
apiguard diff openapi-v1.yaml openapi-v2.yaml

# JSON output for CI pipelines
apiguard diff old.yaml new.yaml --format json

# Fail CI on any breaking change
apiguard diff old.yaml new.yaml --fail-on warning

What It Detects

30+ detection rules covering paths, parameters, responses, request bodies, and deprecations.

Output Formats

apiguard diff v1.yaml v2.yaml                    # Rich terminal table (default)
apiguard diff v1.yaml v2.yaml --format json      # Machine-readable JSON
apiguard diff v1.yaml v2.yaml --format markdown  # Markdown report
apiguard diff v1.yaml v2.yaml --format sarif     # SARIF (Premium)

CI/CD Integration

# .github/workflows/api-check.yml
name: API Breaking Change Check
on: [pull_request]
jobs:
  api-guard:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: pip install kryptorious-apiguard
      - run: apiguard diff main-openapi.yaml pr-openapi.yaml --format json --fail-on error

Comparison

Premium

Upgrade to Premium ($9 lifetime) for:

• SARIF output — GitHub Advanced Security integration
• CI annotations — Inline PR comments on breaking changes
• Custom rules — Define your own breaking change policies
• Team dashboards — Track API stability over time
• Priority support

Get Premium — $9 Lifetime

Requirements

• Python 3.9+
• Handles OpenAPI 3.0 and 3.1 specs
• Supports JSON and YAML input

License

MIT — free for personal and commercial use. Premium features require a license.

Built by Kryptorious Quantum Biosciences.