[v2]: Support `examples` keywords
Author: KevinThompsonYCRXCreated Dec 18, 2024Updated Aug 11, 2026
Is your feature request related to a problem? Please describe.
The example keyword has been deprecated in OpenAPI 3.1 in favor of examples:
Describe the solution you'd like
When the example tag is parsed, place it in a list under examples. Defining a valid separator between examples would be good, but it will also need to be escapable.
Additional context Blog post for 3.1 - you'll need to scroll down to the "Use examples not example" section https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0
Source: swaggo/swag