List view

Start 3.3.0

editorialWording and stylistic issuesWording and stylistic issues

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4982

#4982 In OAI/OpenAPI-Specification;

· ralfhandl opened on Sep 21, 2025

Make patch optional in openapi field.

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

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4929

#4929 In OAI/OpenAPI-Specification;

· handrews opened on Sep 8, 2025

How to state parameter requirements in HTTP headers?

headers

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.

#2458 In OAI/OpenAPI-Specification;

· lmmarsano opened on Feb 12, 2021

Representation of Client-Initiated Backchannel Authentication (CIBA)

security

security: configThe mechanics of severs and structure of security-related objectsThe mechanics of severs and structure of security-related objects

Status: Open.

#4106 In OAI/OpenAPI-Specification;

· SensibleWood opened on Sep 22, 2024

Consolidated $ref-to-Some Object feature request

re-use: ref-everywhereRequests to support referencing in more / all placesRequests to support referencing in more / all places

Status: Open.

#3853 In OAI/OpenAPI-Specification;

· handrews opened on May 24, 2024

allowing $ref in descriptions

re-use: ref-everywhereRequests to support referencing in more / all placesRequests to support referencing in more / all places

Status: Open.

#2697 In OAI/OpenAPI-Specification;

· manasesjesus opened on Sep 3, 2021

Link Object: require referencing operation with unambiguous path template

bug

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

Status: Open.

#4084 In OAI/OpenAPI-Specification;

· ralfhandl opened on Sep 11, 2024

Enhance Response cache-control header

headers

httpSupporting HTTP features and interactionsSupporting HTTP features and interactions

param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization

Status: Open.

#2784 In OAI/OpenAPI-Specification;

· AMorgaut opened on Nov 9, 2021

Use wildcard or regex in cookie name in Cookie Authentication

headers

param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization

security

security: authAuthentication including overlap with authorizationAuthentication including overlap with authorization

Status: Open.

#2296 In OAI/OpenAPI-Specification;

· lauradP opened on Jul 26, 2020

Structural improvements: enhance headers handling

headers

re-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some way

Status: Open.

#690 In OAI/OpenAPI-Specification;

· arno-di-loreto opened on May 11, 2016

Support for structured-headers de/serialization

headers

param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization

Status: Open.

#1980 In OAI/OpenAPI-Specification;

· ioggstream opened on Jul 19, 2019

Parameters for Media Types

headers

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)

request matchingMatching requests to URL templates, media types, etc.Matching requests to URL templates, media types, etc.

Status: Open.

#2342 In OAI/OpenAPI-Specification;

· cjaccino opened on Sep 6, 2020

Is it possible to indicate the requiredness of a <code>multipart/form-data</code>'s request's <code>filename</code> directive?

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)

param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization

Status: Open.

#4442 In OAI/OpenAPI-Specification;

· TomerAberbach opened on Mar 15, 2025

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

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

Supporting of one separate 'required' option for query parameters

param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization

re-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some way

re-use: traits/mergesSelective or modified re-useSelective or modified re-use

Status: Open.

#2347 In OAI/OpenAPI-Specification;

· Morgunov-Vitaly opened on Sep 11, 2020

confusion with schema references in the spec and on the website

Status: Open.

#4817 In OAI/OpenAPI-Specification;

· karenetheridge opened on Aug 1, 2025

Restructure how we mention the JSON Schemas

Schemachanges related to the schema(s)changes related to the schema(s)

Status: Open.

#4870 In OAI/OpenAPI-Specification;

· karenetheridge opened on Aug 14, 2025

Allow required as sibling of $ref (like summary/description)

param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serialization

re-use: traits/mergesSelective or modified re-useSelective or modified re-use

Status: Open.

#2498 In OAI/OpenAPI-Specification;

· radicarl opened on Mar 10, 2021

Provide guidance on using OAS with Overlay and Arazzo

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

Status: Open.

#4221 In OAI/OpenAPI-Specification;

· handrews opened on Nov 21, 2024

Inconsistency in runtime expression examples for request headers

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

Status: Open.

#1323 In OAI/OpenAPI-Specification;

· hkosova opened on Aug 17, 2017

Callbacks runtime expressions in multipart bodies

links

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)

question

Status: Open.

#2146 In OAI/OpenAPI-Specification;

· jdegre opened on Feb 18, 2020

Update dialect link to use 3.3 version

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4996

#4996 In OAI/OpenAPI-Specification;

· valerii15298 opened on Sep 25, 2025