OpenAPI-Specification icon indicating copy to clipboard operation
OpenAPI-Specification copied to clipboard

The OpenAPI Specification Repository

Results 476 OpenAPI-Specification issues
Sort by recently updated
recently updated
newest added

In the Swagger 2.0 specification, there is support for adding a `License` as one of the informational fields and the description for this is `License information for the exposed API.`...

review
clarification
editorial

I'm reading about [Server Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#server-object) and [Server Variables](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#server-variable-object), and trying to understand how resolution/expansion is supposed to work. The OpenAPI document can specify any number of servers, each with zero...

review
clarification

1\. The [Special Considerations for multipart Content](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#special-considerations-for-multipart-content) section says: > In contrast to 2.0, a `schema` is REQUIRED to define the input parameters to the operation when using `multipart` content....

review
clarification
media and encoding

Partially closes https://github.com/OAI/OpenAPI-Specification/issues/3854 We have moved in this https://github.com/OAI/learn.openapis.org/pull/102 the examples to the learn.openapis.org repo. So in this PR we are cleaning the main branch by removing the examples folder...

examples

## 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...

Housekeeping

This script updates the schema IDs in the following YAML files: - schemas/v{major}.{minor}/schema.yaml - schemas/v{major}.{minor}/schema-base.yaml and generates the following JSON files from the updated YAML files: - schemas/v{major}.{minor}/schema.json - schemas/v{major}.{minor}/schema-base.json

Schema
script

the specification indicates > The encoding object SHALL only apply to requestBody objects when the media type is multipart or application/x-www-form-urlencoded. This PR codifies that behavior in the JSON Schema...

Schema

Partially closes https://github.com/OAI/OpenAPI-Specification/issues/3854 We have moved in this https://github.com/OAI/learn.openapis.org/pull/102 the examples to the learn.openapis.org repo. So in this PR we are cleaning the main branch by removing the examples folder...

examples

Partially closes https://github.com/OAI/OpenAPI-Specification/issues/3854 We have moved in this https://github.com/OAI/learn.openapis.org/pull/102 the examples to the learn.openapis.org repo. So in this PR we are cleaning the main branch by removing the examples folder...

examples

Partially closes https://github.com/OAI/OpenAPI-Specification/issues/3854 We have moved in this https://github.com/OAI/learn.openapis.org/pull/102 the examples to the learn.openapis.org repo. So in this PR we are cleaning the main branch by removing the examples folder...

examples