Versioning

Versioning

An index and topic collection covering API versioning patterns, schema evolution, and breaking-change detection across the API lifecycle. API versioning communicates change to consumers, while schema versioning and diff tooling makes those changes explicit, reviewable, and reversible. This collection brings together versioning approaches like SemVer and CalVer, registry-driven schema evolution platforms (Apollo, Buf, Apicurio, Confluent Schema Registry), spec-diff tools (oasdiff, Optic, Bump.sh, GraphQL Inspector), API documentation versioning (Stoplight, Scalar, Bump.sh), versioning headers and sunsetting practices (Stripe API Versioning, Sunset Header), and dependency-versioning automation (Dependabot, Renovate, Conventional Commits).

articleAll API Stories

56 stories relevant to Versioning, pulled from across the API Evangelist network blog feeds.

article

A Federated API Governance Rule Registry

article
article
article
article

spec2openapi 0.1.0

article
article
article
article
article

Beta SDKs for the 2026-07-28 MCP Spec Release Candidate Are Here

article
article
article
article

Build your MCP registry

article

OpenAPI Specification

article
article

The 2026-07-28 MCP Specification Release Candidate

article
article
article
article
article
article
article
article
article
article
article
article
article
article
article

What Is Your Beef With JSON Schema?

article
article
article
article
article
article

One Year of MCP: November 2025 Spec Release

article
article
article
article
article

Introducing the MCP Registry

article
article

Changing specs: from Swagger to OpenAPI

article
article
article
article
article
article
article
article

Creating OpenAPI Specifications

article
article
article

Make the Perfect JSON Schema