OpenAPI-Specification
OpenAPI-Specification copied to clipboard
The OpenAPI Specification Repository
Currently the [openapi v3.0 schema](https://github.com/OAI/OpenAPI-Specification/blob/main/schemas/v3.0/schema.json) is using `draft-04` of json schema. Would it be possible to get an updated version of the schema using `Draft 2019-09` or `2020-12`? We are...
The current state of affairs is that responses can be defined as components and referenced with the `"$ref":"{uri}"` syntax, but these cannot be composed using the `allOf` directive. Trying to...
**NOTE: This meeting is on Thursday at 9am - 10am PT** Zoom Meeting link: [https://zoom.us/j/975841675](https://zoom.us/j/975841675?pwd=SUh4MjRLaEFKNlI3RElpWTdhRDVVUT09). Dial-in passcode: 763054 - [Code-of-Conduct](https://github.com/OAI/OpenAPI-Specification/blob/main/CODE_OF_CONDUCT.md#code-of-conduct) In order to give some more visibility into the topics...
let say reposne is compound of schema1 and right after schema 2 but schema 2 appears only for a specific user that runs the API
Clone of PR #2401, resubmitted against the `v3.2.0-dev` branch [as requested by webron](https://github.com/OAI/OpenAPI-Specification/pull/2401#issuecomment-1170594516). Note that this is not submitted against the `main` branch, but I will happily resubmit it against...
Hi, Is there any way to make the body optional in **Swagger v2**? I am getting error as the required array is empty in the "Formatting" definition: ["Formatting": { "required":...
The introductory paragraph currently reads: "The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs..." I think it should rather read: "The OpenAPI Specification (OAS) defines...
My use case is the following: I have several schema definitions. The API should return these definitions always wrapped in a certain structure. So my idea would be to have...