Discussions

• 1 You must be logged in to vote

  💡

  Are there plans to add support for global responses?

  davidkeaveny started Oct 2, 2025 in Enhancements

  

  

  

  

  5
• 3 You must be logged in to vote

  ❓

  Same endpoint for POST and GET method without the duplicate key error?

  Nikola-Milovic asked Sep 3, 2021 in Q&A · Closed · Answered

  

  

  

  

  11
• 1 You must be logged in to vote

  💬

  How to create a new version dev branch such as v3.3-dev?

  Process

  ralfhandl started Aug 17, 2025 in General · Closed

  

  

  9
• 1 You must be logged in to vote

  ❓

  Represent XML tag with multiple namespaces

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

  nickkpiccoli asked Sep 24, 2025 in Q&A · Answered

  

  

  

  

  5
• 1 You must be logged in to vote

  ❓

  Clarification on Best Practices for Extending OpenAPI Specification

  fatema432 asked Sep 23, 2025 in Q&A · Answered

  

  

  

  

  4
• 1 You must be logged in to vote

  💬

  Should we put out a 3.0.5 (or formal Errata for 3.0.4)?

  Process

  handrews started Aug 13, 2025 in General

  

  

  

  

  26
• 1 You must be logged in to vote

  💡

  Allow more attributes for "Reference Object"

  re-use: traits/merges Selective or modified re-use

  Amit-XMPie started Dec 2, 2024 in Enhancements · Closed

  

  

  

  

  19
• 1 You must be logged in to vote

  💬

  API specification format for hypermedia-centric APIs

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

  someniatko started Nov 9, 2024 in General

  

  

  2
• 1 You must be logged in to vote

  💡

  Content type sniffing priority (3.3+)

  http Supporting HTTP features and interactions registries Related to any or all spec.openapis.org-hosted registries

  hudlow started Jul 18, 2025 in Enhancements

  

  

  3
• 1 You must be logged in to vote

  ❓

  Can we create a subfolder like structure? to display it on readme.io

  vaibhavshah08 asked Aug 20, 2025 in Q&A · Closed · Answered

  

  

  

  

  7
• 1 You must be logged in to vote

  ❓

  Is there any guidance on the maximum no of end-points an API can have?

  teja-v1 asked Aug 11, 2025 in Q&A · Closed · Answered

  

  

  1
• 1 You must be logged in to vote

  ❓

  multiple path parameters and strings in same path segment conform to OAS 3.0.x ?

  amolari asked Jan 15, 2025 in Q&A · Closed · Unanswered

  

  

  2
• 2 You must be logged in to vote

  💡

  Registry of media type modeling approaches

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

  handrews started May 1, 2024 in Enhancements · Closed

  

  

  2
• 1 You must be logged in to vote

  💬

  OAD Structure and referencing in OpenAPI 3.1

  mikekistler started Sep 25, 2024 in General · Closed

  

  

  

  

  30
• 1 You must be logged in to vote

  💡

  Allow description to be an object as well as a string

  darcyrush started Nov 21, 2024 in Enhancements · Closed

  

  

  4
• 5 You must be logged in to vote

  💡

  Proposal for OpenAPI Extension: x-sensitive-data

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

  cristigirbovan started Feb 5, 2025 in Enhancements

  

  

  

  

  3
• 1 You must be logged in to vote

  ❓

  Security Schema, env/server dependent

  security security: config The mechanics of severs and structure of security-related objects

  DavDeDev asked Sep 5, 2025 in Q&A · Unanswered

  

  

  

  

  10
• 2 You must be logged in to vote

  💬

  Schema Releases

  Schema changes related to the schema(s)

  ralfhandl started Sep 13, 2025 in General

  

  

  3
• 4 You must be logged in to vote

  💡

  3.3: allow openapi field to just specify MAJOR.MINOR and omit the PATCH number

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

  ralfhandl started Nov 28, 2024 in Enhancements

  

  

  

  

  82
• 1 You must be logged in to vote

  💡

  Schema test coverage: split tests into versioned directories

  karenetheridge started Aug 14, 2025 in Enhancements · Closed

  

  

  7
• 3 You must be logged in to vote

  ❓

  How should parameter examples be written?

  chrisradek asked May 20, 2025 in Q&A · Closed · Answered

  

  

  

  

  42
• 20 You must be logged in to vote

  💡

  An SSE Proposal

  robertlagrant started Nov 1, 2024 in Enhancements · Closed

  

  

  

  

  57
• 1 You must be logged in to vote

  ❓

  JSON Schema for YAML usage

  char0n asked May 29, 2025 in Q&A · Closed · Unanswered

  

  

  5
• 2 You must be logged in to vote

  💬

  Strategies on documenting filter query format in OpenAPI spec

  geoff-maddock started Dec 19, 2022 in General · Closed

  

  

  

  

  7
• 2 You must be logged in to vote

  💡

  Security: Add optional client_id attribute to OAuth2

  security security: auth Authentication including overlap with authorization

  hfhbd started Aug 12, 2025 in Enhancements

  

  

  

  

  3