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

We need a test for the schema coverage measurement script [`schema-test-coverage.mjs`](https://github.com/OAI/OpenAPI-Specification/blob/main/scripts/schema-test-coverage.mjs) provided by @jdesrosiers so we notice if it breaks again.

Housekeeping

We link to the media types registry from the changes in https://github.com/OAI/OpenAPI-Specification/pull/4590 (querystring) - publish it and add it to the issue template for adding to registries before we publish...

registries

Hi, In the OpenAPI spec, when defining a [Callback Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#callback-object), you can use a [runtime expression](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#runtime-expressions) in the form of: ``` $request.body#... ``` What goes after "body" should be a...

question
links
media and encoding

Hi! For example, there are several paths that include similar parameters, but with different required options: in some paths parameters are required, in others they are optional. If we can...

param serialization
re-use: traits/merges
re-use: globals/defaults

Many long-requested features for OAS can now be better handled by using the Overlay and/or Arazzo specifications. I think Arazzo mostly overlaps with the Link Object, but I might be...

clarification

@karenetheridge and @notEthan raised various points about confusion and usage of the Server Object and its `url` field in PR #4389. From @karenetheridge > We can also offer caution that...

deployment

PR #3234 proposes a `url-template` format, and is currently in discussion regarding the scope and naming of the format. PR #3235 applied the format to the current schema, resulting in...

Schema
format-registry