Stop Guessing Your API Version Bump
Delimit deterministically classifies every OpenAPI diff as major, minor, or patch. No manual review, no guesswork.
Every time your OpenAPI spec changes, someone has to decide: is this a patch, a minor, or a major version bump? Most teams guess. Some skip versioning entirely. Both approaches break downstream consumers.
Delimit makes this deterministic. It reads the diff between your base branch spec and the PR branch spec, classifies every change, and tells you the version bump:
- MAJOR -- any breaking change (endpoint removed, type changed, required param added, etc.)
- MINOR -- additive changes only (new endpoints, optional fields, new enum values)
- PATCH -- non-functional changes (description edits, examples updated)
- NONE -- specs are identical
This isn't AI inference. It's deterministic rules applied to a structured diff. The same input always produces the same classification.
Try it
npx delimit-cli diff old-api.yaml new-api.yaml
Or add the GitHub Action and get semver classification on every PR automatically.
Try the GitHub Action
Add breaking change detection to any repo with an OpenAPI spec.
- uses: delimit-ai/delimit-action@v1
with:
spec: path/to/openapi.yamlView on Marketplace