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

Since XML has no concept of `null`, how can we handle validating a null value (both as an attribute and as an element) ? consider the following 3.0 schema :...

xml
media and encoding

I've been writing up guides for contract testing with OpenAPI in a bunch of different languages, and [the Ruby on Rails one](https://docs.bump.sh/guides/openapi/design-first-rails/) using [https://github.com/mkon/openapi_contracts/](mkon/openapi_contracts) gave this great example, letting me...

clarification
media and encoding

Hi, How to express in OpenAPI that a response payload is optional for a given HTTP response code? I noticed that the keyword "required: true/false" is applicable only to Request...

question
media and encoding

This PR adds the Overlay specification to the landing page of https://spec.openapis.org. Note: merge only after the Overlay specification has been published! Overlay publishing PR: * #4145

Housekeeping

I'd like to merge this and address it in the build scripts rather than resuming publication of schemas with absent dates and misleading patch release guidance. * Replace all dates...

Schema

Currently, we have the following schema document `$id`s for OAS 3.1 (shown relative to a base URI of `https://https://spec.openapis.org/oas/3.1/`, and without the trailing date segment that all schemas need to...

Schema

- [x] GitHub workflow - [x] bash script called from workflow - [x] JS script to convert YAML to JSON and patch iteration date - [x] unit tests for JS...

Schema
script

This pull request is automatically triggered by GitHub action `respec`. The `versions/*.md` files have changed, so the HTML files are automatically being regenerated.

Housekeeping