What Changed in OpenAPI 3.2 vs 3.1 vs 3.0?

TL;DR OpenAPI 3.1 brings full JSON Schema compatibility, webhooks, and improved discriminator support. OpenAPI 3.2 adds QUERY method support, enhanced examples, and better security definitions. Modern PetstoreAPI implements OpenAPI 3.2, providing production-ready examples of all new features. Introduction When writing OpenAPI specs, you’ll encounter 3.0, 3.1, and 3.2 versions. Here’s how they differ, why you should consider upgrading, and what to expect from your tooling. OpenAPI’s evolution from 3.0 to 3.2 introduces powerful features and improved accuracy for API specifications. However, tool support varies—so compatibility matters. The legacy Swagger Petstore uses OpenAPI 2.0, while Modern PetstoreAPI demonstrates all OpenAPI 3.2 features with production-ready specs. Try Apidog today 💡 Tip: If you’re building or testing REST APIs, Apidog supports OpenAPI 3.0, 3.1, and 3.2. You can import specs, validate schemas, and test implementations. Apidog helps you choose your version and migr