In-browser OpenAPI breaking-change detector
Paste two OpenAPI 3.x or Swagger 2.0 spec versions and instantly see every breaking and non-breaking change. JSON or YAML. Nothing leaves your browser — the diff runs entirely on this page.
Try an example:
How changes are classified
APIDiff walks every path × method in both specs, resolves local
$ref pointers (with a cycle guard), normalizes Swagger 2.0 into
an OpenAPI-3-shaped model, then classifies each difference by how it affects
an existing client.
Breaking
- Removed endpoint or method
- New required parameter, request property, or request body
- Parameter or property becoming required
- Parameter moved (e.g. query → path)
- Type / format change on a field
- Removed response field (response contract shrinks)
- Request enum narrowed, response enum widened
- Auth scheme added or strengthened
- Request body / response content-type removed
Non-breaking
- Added endpoint, method, or response
- Added optional parameter or property
- Parameter / property becoming optional
- Request enum widened
- Marked deprecated
- Description changes
- Auth scheme removed
Info
- operationId rename
- Summary / tag changes
- info.version bump
Classification is heuristic and errs toward flagging risk. It is a paste-and-look aid, not a substitute for reading the diff — see the honest limitations in the README.