dotnet/aspnet-api-versioning

ASP.NET API Versioning is a set of libraries that add API versioning to ASP.NET Core Minimal APIs, Controllers, gRPC, OData, and classic Web API applications.

The tool addresses the challenge of managing multiple API versions in REST services by providing metadata attributes and conventions that describe which versions are implemented by your endpoints. Rather than requiring new routing concepts or changes to how you build services, it layers versioning semantics onto your existing ASP.NET implementation. The default configuration follows the Microsoft REST Guidelines versioning semantics, with customization points available for services that need different versioning approaches or are transitioning from unversioned APIs.

The project supports a broad range of ASP.NET flavors: ASP.NET Core Minimal APIs, ASP.NET Core MVC, ASP.NET Core gRPC, ASP.NET Core with OData, and classic Web API with and without OData. Beyond core versioning, it includes API explorer and OpenAPI documentation support for versioned APIs across these platforms, as well as client-side HTTP client libraries for creating version-aware API consumers. Choose this tool if you need to version existing or new REST services without restructuring your application architecture, or if you require OpenAPI documentation that accounts for multiple API versions.

The project maintains active engagement with contributors through documented contribution guidelines and discussion channels. Development activity shows consistent attention to the codebase with regular updates across multiple supported platforms and frameworks. The breadth of supported ASP.NET variants indicates ongoing effort to keep the tool compatible as the ecosystem evolves.