List view

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

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

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

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

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

Use semicolon(;) in Path Parameters

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

Status: Open.

#1710 In OAI/OpenAPI-Specification;

· amirmasud opened on Oct 15, 2018

Support for arbitrary query strings

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

Status: Open.

#1502 In OAI/OpenAPI-Specification;

· pofallon opened on Mar 6, 2018

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

How to disallow unknown query parameter?

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

Status: Open.

#2511 In OAI/OpenAPI-Specification;

· smikulcik opened on Mar 25, 2021

Support <code>multipart/byteranges</code> for 206 responses

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.

#3725 In OAI/OpenAPI-Specification;

· handrews opened on Apr 20, 2024

Support for <code>multipart/mixed</code> (and possibly better <code>multipart/*</code> support in general)

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.

#3721 In OAI/OpenAPI-Specification;

· handrews opened on Apr 19, 2024

v3.2: Decide on names of new Example Object fields

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

Status: Open.

#4658 In OAI/OpenAPI-Specification;

· handrews opened on Jun 5, 2025

v3.2: Should the <code>value</code> and <code>externalValue</code> fields be deprecated?

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

Status: Open.

#4660 In OAI/OpenAPI-Specification;

· handrews opened on Jun 5, 2025

v3.2: Should the <code>example</code> field be deprecated (Parameter, Header, and Media Type Objects)

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

Status: Open.

#4661 In OAI/OpenAPI-Specification;

· handrews opened on Jun 5, 2025

v3.2: Add data vs serialized Example Object fields (Revised)

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

Status: Draft (not ready).

OAI/OpenAPI-Specificationnumber 4671

#4671 In OAI/OpenAPI-Specification;

· handrews opened on Jun 9, 2025

v3.2: Example Object example updates for new fields

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

Status: Draft (not ready).

OAI/OpenAPI-Specificationnumber 4672

#4672 In OAI/OpenAPI-Specification;

· handrews opened on Jun 9, 2025

v3.2: Explain Param/Header/Enc example serialization

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

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

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4673

#4673 In OAI/OpenAPI-Specification;

· handrews opened on Jun 9, 2025

v3.2: XML Object example updates

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

xml

Status: Draft (not ready).

OAI/OpenAPI-Specificationnumber 4711

#4711 In OAI/OpenAPI-Specification;

· handrews opened on Jun 13, 2025

v3.2: Allow Media Type and Encoding re-use

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 4728

#4728 In OAI/OpenAPI-Specification;

· handrews opened on Jun 16, 2025

Prepare 3.2.0 and 3.1.2 releases

Status: Open.

#4595 In OAI/OpenAPI-Specification;

· lornajane opened on May 16, 2025

v3.2: Add support for application/linkset[+json]

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 (in progress).

OAI/OpenAPI-Specificationnumber 4740

#4740 In OAI/OpenAPI-Specification;

· handrews opened on Jun 18, 2025

v3.2: Guidance on searching and evaluating 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)

schema-object

Status: Open (in progress).

OAI/OpenAPI-Specificationnumber 4743

#4743 In OAI/OpenAPI-Specification;

· handrews opened on Jun 21, 2025

v3.2: Provide guidance for multiple contentType values

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 4744

#4744 In OAI/OpenAPI-Specification;

· handrews opened on Jun 21, 2025

v3.2: (Split and smaller!) Support ordered multipart including streaming

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 4745

#4745 In OAI/OpenAPI-Specification;

· handrews opened on Jun 21, 2025

v3.2: Ordered <code>multipart</code> examples

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 4746

#4746 In OAI/OpenAPI-Specification;

· handrews opened on Jun 21, 2025