-
Notifications
You must be signed in to change notification settings - Fork 9.2k
OpenAug 27, 2026
No due date
•Last updated INTERNAL USE ONLY. Our process is not your process, information about specification changes should be taken only from the in-progress, publicly-available specification versions in the repository.
48% complete
List view
0 of 20 selected 0 issues of 20 selected
How to state parameter requirements in HTTP 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;Consolidated $ref-to-Some Object feature request
re-use: ref-everywhereRequests to support referencing in more / all placesRequests to support referencing in more / all placesStatus: Open.#3853 In OAI/OpenAPI-Specification;allowing $ref in descriptions
re-use: ref-everywhereRequests to support referencing in more / all placesRequests to support referencing in more / all placesStatus: Open.#2697 In OAI/OpenAPI-Specification;Link Object (and Arazzo?): require referencing operation with unambiguous path template
re-use: ref/id resolutionhow $ref, operationId, or anything else is resolvedhow $ref, operationId, or anything else is resolvedStatus: Open.#4084 In OAI/OpenAPI-Specification;Enhance Response cache-control header
httpSupporting HTTP features and interactionsSupporting HTTP features and interactionsparam serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationStatus: Open.#2784 In OAI/OpenAPI-Specification;Structural improvements: enhance headers handling
re-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some wayStatus: Open.#690 In OAI/OpenAPI-Specification;Support for structured-headers de/serialization
param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationStatus: Open.#1980 In OAI/OpenAPI-Specification;Parameters for Media Types
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;Is it possible to indicate the requiredness of a
multipart/form-data's request'sfilenamedirective?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 serializationStatus: Open.#4442 In OAI/OpenAPI-Specification;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 resolvedsecurity: metaMetadata in and about the specificationMetadata in and about the specificationStatus: Open.#4037 In OAI/OpenAPI-Specification;Supporting of one separate 'required' option for query parameters
param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationre-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some wayre-use: traits/mergesSelective or modified re-useSelective or modified re-useStatus: Open.#2347 In OAI/OpenAPI-Specification;Allow required as sibling of $ref (like summary/description)
param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationre-use: traits/mergesSelective or modified re-useSelective or modified re-useStatus: Open.#2498 In OAI/OpenAPI-Specification;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 specStatus: Open.#4221 In OAI/OpenAPI-Specification;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 specStatus: Open.#1323 In OAI/OpenAPI-Specification;Callbacks runtime expressions in multipart bodies
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.#2146 In OAI/OpenAPI-Specification;- Status: Open.#1552 In OAI/OpenAPI-Specification;
v3.3: Global parameters
param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationre-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some wayStatus: Open.#5320 In OAI/OpenAPI-Specification;Add default responses
re-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some wayStatus: Open.#563 In OAI/OpenAPI-Specification;Share header with multiple response objects
re-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some wayStatus: Open.#369 In OAI/OpenAPI-Specification;v3.3: Allow
in: queryandin: querystringand/or multiplein: querystrings together?param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationStatus: Open.#5366 In OAI/OpenAPI-Specification;