List view

v3.2 Arrange encoding information more clearly

media and encodingIssues regarding media type support and how to encode data (outside of query/path params)Issues regarding media type support and how to encode data (outside of query/path params)

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4562

#4562 In OAI/OpenAPI-Specification;

· handrews opened on May 1, 2025

v3.2: <code>$self</code> field (Alternative Approach)

re-use: ref/id resolutionhow $ref, operationId, or anything else is resolvedhow $ref, operationId, or anything else is resolved

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4556

#4556 In OAI/OpenAPI-Specification;

· handrews opened on Apr 29, 2025

v3.2: Sequential/streaming media types (take 2)

media and encodingIssues regarding media type support and how to encode data (outside of query/path params)Issues regarding media type support and how to encode data (outside of query/path params)

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4554

#4554 In OAI/OpenAPI-Specification;

· handrews opened on Apr 28, 2025

v3.2: Consider requiring <code>$self</code> to be an absolute-URI

re-use: ref/id resolutionhow $ref, operationId, or anything else is resolvedhow $ref, operationId, or anything else is resolved

Status: Open.

#4548 In OAI/OpenAPI-Specification;

· handrews opened on Apr 23, 2025

Support API-wide version information

metadatatags, info, license, contact, markdown usage, etc.tags, info, license, contact, markdown usage, etc.

registriesRelated to any or all spec.openapis.org-hosted registriesRelated to any or all spec.openapis.org-hosted registries

Status: Open.

#4212 In OAI/OpenAPI-Specification;

· dret opened on Nov 21, 2024

Add requirements or recommendations about allow/deny lists for reference target retrieval

re-use: ref/id resolutionhow $ref, operationId, or anything else is resolvedhow $ref, operationId, or anything else is resolved

security: metaMetadata in and about the specificationMetadata in and about the specification

Status: Open.

#4037 In OAI/OpenAPI-Specification;

· handrews opened on Aug 17, 2024

Formalize how to express null value in xml

media and encodingIssues regarding media type support and how to encode data (outside of query/path params)Issues regarding media type support and how to encode data (outside of query/path params)

xml

Status: Open.

#3959 In OAI/OpenAPI-Specification;

· ahmednfwela opened on Jul 16, 2024

remove "Optional OAuth2 security" examples

examplesrequests for more or better examples in the specificationrequests for more or better examples in the specification

security

Status: Open.

#3777 In OAI/OpenAPI-Specification;

· AxelNennker opened on May 3, 2024

Support application/json-seq and similar JSON-based sequential formats

enhancement

media and encodingIssues regarding media type support and how to encode data (outside of query/path params)Issues regarding media type support and how to encode data (outside of query/path params)

Status: Open.

#3730 In OAI/OpenAPI-Specification;

· handrews opened on Apr 20, 2024

Add tokenExchange grant type to list of allowed grant types for oauth2 shape

security

security: access ctrlPermissions and controls distinct from authenticationPermissions and controls distinct from authentication

Status: Open.

#3709 In OAI/OpenAPI-Specification;

· kaheidt opened on Apr 16, 2024

Enhancing specification to describe token presentation mechanisms for OAuth 2.0

security

security: authAuthentication including overlap with authorizationAuthentication including overlap with authorization

Status: Open.

#3612 In OAI/OpenAPI-Specification;

· alex-feel opened on Feb 28, 2024

Add info to security considerations about outdated security practices, and link in new versions

security

security: metaMetadata in and about the specificationMetadata in and about the specification

Status: Open.

#3603 In OAI/OpenAPI-Specification;

· handrews opened on Feb 22, 2024

Define formats for URL templating with and without runtime expressions

format-registry

Schema

Status: Open.

#3530 In OAI/OpenAPI-Specification;

· handrews opened on Jan 26, 2024

YAML JSON Schema is not enough for roundtrip-safe

metadatatags, info, license, contact, markdown usage, etc.tags, info, license, contact, markdown usage, etc.

review

Status: Open.

#2951 In OAI/OpenAPI-Specification;

· ioggstream opened on Jun 22, 2022

OAS3 Tag/template to define external-components URL

re-use: ref/id resolutionhow $ref, operationId, or anything else is resolvedhow $ref, operationId, or anything else is resolved

Status: Open.

#1979 In OAI/OpenAPI-Specification;

· gerardbosch opened on Jul 19, 2019

Add top level XML code generation hints

media and encodingIssues regarding media type support and how to encode data (outside of query/path params)Issues regarding media type support and how to encode data (outside of query/path params)

schema-object

xml

Status: Open.

#1652 In OAI/OpenAPI-Specification;

· silkentrance opened on Aug 3, 2018

xml property and root schemas

media and encodingIssues regarding media type support and how to encode data (outside of query/path params)Issues regarding media type support and how to encode data (outside of query/path params)

xml

Status: Open.

#1435 In OAI/OpenAPI-Specification;

· MikeRalphson opened on Dec 13, 2017

Proposal: Having an example for an entire operation in one place (request + response)

example obj/keywordsIssues with the Example Object or exampel(s) keywordsIssues with the Example Object or exampel(s) keywords

Status: Open.

#859 In OAI/OpenAPI-Specification;

· amarzavery opened on Dec 23, 2016

Clarification on the purpose of the API license?

clarificationrequests to clarify, but not change, part of the specrequests to clarify, but not change, part of the spec

editorialWording and stylistic issuesWording and stylistic issues

review

Status: Open.

#726 In OAI/OpenAPI-Specification;

· harrisj opened on Jul 7, 2016

How to represent XML elements with attributes

media and encodingIssues regarding media type support and how to encode data (outside of query/path params)Issues regarding media type support and how to encode data (outside of query/path params)

xml

Status: Open.

#630 In OAI/OpenAPI-Specification;

· micovery opened on Apr 7, 2016