Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Is Arazzo available in OAS 2.0 #372

Sara-cunningham started this conversation in General
Discussion options

Our company is still using OpenAPI v2 will Arazzo work or will we need to upgrade to 3.0.1 or higher

You must be logged in to vote

Replies: 2 comments

Comment options

While you could reference a swagger 2.0 doc in the sourceDocuments section, tooling support and some aspects (e.g. operationRef) are going to be dependent on OpenAPI 3.x and later. I would advise migrating to OpenAPI 3.0 or later as it's been out for quite some time now, and there are a variety of tools that can help with that, but if that is not possible, I don't know that you'd want to embrace Arazzo until you have migrated to 3.x or later.

You must be logged in to vote
0 replies
Comment options

@Sara-cunningham while the OpenAPI community in general encourages everyone to upgrade from OpenAPI v2 to later versions of the OpenAPI Specification (which I believe is the sentiment of @kevinduffey response), remaining on v2 does not stop you from describing use-cases and workflows with Arazzo.

Let me know if you hit any issues, but in general all should be fine.

You must be logged in to vote
0 replies
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

AltStyle によって変換されたページ (->オリジナル) /