#1949·swag

[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