Detect Breaking Changes
Don't break your consumers, catch breaking changes early! Optic makes it easy for every developer to understand if they've proposed breaking API changes before they are released. Breaking change checks helps your team keep its promises to consumers.
Detecting breaking changes
Optic can lint your API design, OpenAPI document and the changes between versions. Optic ships with built-in rules that check the changes between each version for breaking changes. Breaking change checks are enabled by adding --check
flag to optic diff
:
optic diff openapi.yaml --base main --check

Read full documentation for optic diff
Visualizing Breaking Changes
For a more detailed view of breaking API changes, you can include the --web
flag. This computes the changelog locally and includes it via a URL to Optic's visual changelog view (we do not save the data).
optic diff openapi.yaml --base main --check --web
Catch Breaking Changes in CI
You can set up Optic Cloud to catch breaking changes in CI. Optic can be set up to fail CI on Pull Requests that introduce known breaking changes to consumers. Learn more here