# OpenAPI Versioning

**Canonical:** https://apis.io/apis/versioning-protocols/openapi-versioning/  
**Provider:** Versioning Protocols — https://apis.io/providers/versioning-protocols/  
**Documentation:** https://openapispec.com/docs/how/how-does-openapi-handle-api-versioning/

OpenAPI Versioning is one of 5 APIs that [Versioning Protocols](https://apis.io/providers/versioning-protocols/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include OpenAPI, API Specification, Breaking Changes, and Deprecation. The published artifact set on APIs.io includes API documentation.

OpenAPI handles versioning through the info.version field (using SemVer), the deprecated flag on individual operations, parameters, and schemas, and multiple server entries for different API versions. Tools like oasdiff enable automated breaking change detection between OpenAPI spec versions.

## Machine-readable artifacts (1)

- **Documentation** — https://openapispec.com/docs/how/how-does-openapi-handle-api-versioning/

## Other Versioning Protocols APIs (4)

- [Semantic Versioning (SemVer)](https://apis.io/apis/versioning-protocols/semver/)
- [Calendar Versioning (CalVer)](https://apis.io/apis/versioning-protocols/calver/)
- [URI Path Versioning](https://apis.io/apis/versioning-protocols/uri-path-versioning/)
- [Header-Based Versioning](https://apis.io/apis/versioning-protocols/header-versioning/)

## Tags

OpenAPI, API Specification, Breaking Changes, Deprecation

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/versioning-protocols/openapi-versioning/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/versioning-protocols/.