Skip to main content

🚀 Beta: All Pro and Team features are free. Install on GitHub →

OpenAPI 2.0 · 3.0 · 3.1

OpenAPI Breaking Change Detection

Automatically detect breaking changes in your OpenAPI specs on every pull request. GitHub-native. Zero configuration. Free forever.

Full OpenAPI support

Swagger 2.0

Full support for legacy Swagger/OpenAPI 2.0 specifications.

OpenAPI 3.0

Complete support for OpenAPI 3.0.x with all schema features.

OpenAPI 3.1

Full JSON Schema compatibility with OpenAPI 3.1.x support.

10 breaking change types detected

Endpoint Removal

DELETE /api/users was removed

Required Field Added

New required field "email" in POST /users request body

Response Field Removal

Field "name" removed from GET /users response

Type Change

Field "age" changed from integer to string

Auth Scheme Change

Security scheme changed from API key to OAuth2

Enum Value Removal

Value "admin" removed from role enum

Path Parameter Change

Parameter "userId" renamed to "id"

Response Code Removal

HTTP 201 response removed from POST /orders

Constraint Tightening

maxLength reduced from 255 to 100

Content Type Change

Media type changed from JSON to XML

How it works

1

Install the GitHub App

One click. Select repositories. No YAML, no CI changes, no tokens.

2

Open a pull request

CodeRifts auto-discovers OpenAPI specs and compares base vs. head.

3

Review the report

Get a detailed PR comment with breaking changes, risk score, and migration guidance.

Supported file formats

CodeRifts auto-discovers spec files by content, not just file extension.

Format Extensions Status
YAML .yaml .yml Supported
JSON .json Supported
Bundled / Multi-file $ref resolution Supported

Why CodeRifts for OpenAPI?

Feature CodeRifts oasdiff CLI Optic (archived)
Zero config
GitHub-native (no CI changes)
Auto-discovery of specs
Risk scoring
Policy engine
Actively maintained Archived

Optic was archived on January 12, 2026. Read our migration guide →

Start detecting OpenAPI breaking changes today.

Install in 30 seconds. No YAML. No CI changes. No tokens. Free forever.