Back to blog
2026-03-22 4 min read

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.yaml
View on Marketplace
#semver#openapi#ci