OpenAPI-Specification
OpenAPI-Specification copied to clipboard
OAI
The OpenAPI Specification Repository
Resolving component names used in _referenced_ (as opposed to _entry_) documents is ambiguous, particularly in 3.1 where we advertise the ability to have a `components`-only document to use as a...
In the Request Body Examples section of both [3.0](https://spec.openapis.org/oas/v3.0.3#request-body-examples) and [3.1](https://spec.openapis.org/oas/v3.1.0#request-body-examples), the second example is as follows (JSON omitted for brevity): ----- A body parameter that is an array of...
## Weekly meetings happen on Thursdays at 9am - 10am Pacific This agenda gives visibility into discussion topics for the weekly Technical Developer Community (TDC) meetings. Sharing agenda items in...
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "github-actions[bot] avatar"){kind=avatar}
With the Workflows specification reaching a 1.0 release, it will outgrow the "Special Interest Groups" moniker. This issue is meant to track the updates required to various governing documents either...
Looking at the [Style Examples](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#style-examples) I cannot see what style I should use in the following instance: A parameter `in: query` of `type: array` such that I could accept the...
At the moment, we are working towards releasing three releases, off three branches (`v3.0.4-dev`, `v3.1.1-dev`, `v3.2.0-dev`). In order to release consistent documents (please let's not face-plant with our first releases...
It grieves me to even bring this up, as no one is a fan of the special-case behavior of `$ref` with siblings in the Path Item Object. But I feel...
[RFC7231 4.7.3](https://tools.ietf.org/html/rfc7231#section-4.3.7) identifies the use of target resource '*' when using the OPTIONS method. However, per [3.1.0 RC0's requirement for patterned fields for the Path Item Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#patterned-fields), the 'resource MUST...
Use case is XML where one of several states are indicated via presence of one of several possible elements, so that the name of the element is the relevant value....
The `allowReserved` keyword in the Parameter Object is specified as follows (from 3.1.0): > Determines whether the parameter value SHOULD allow reserved characters, as defined by [[RFC3986](https://spec.openapis.org/oas/latest.html#bib-RFC3986)] `:/?#[]@!$&'()*+,;=` to be...