- 
                Notifications
    You must be signed in to change notification settings 
- Fork 9.2k
OAI OpenAPI-Specification Enhancements Discussions
  
    
        Sort by:
        Latest activity
      
  
    
      
    
    Categories, most helpful, and community links
Categories
Community links
          💡 Enhancements Discussions
        
          Have an idea for how to improve the spec? Start here!
      - 
  You must be logged in to vote 💡 Are there plans to add support for global responses?re-use: globals/defaultsDefault or global components that can be overridden in some way 
- 
  You must be logged in to vote 💡 Allow more attributes for "Reference Object"re-use: traits/mergesSelective or modified re-use 
- 
  You must be logged in to vote 💡 Content type sniffing priority (3.3+)OAI-scope httpSupporting HTTP features and interactions registriesRelated to any or all spec.openapis.org-hosted registries 
- 
  You must be logged in to vote 💡 Registry of media type modeling approachesmedia and encodingIssues regarding media type support and how to encode data (outside of query/path params) 
- 
  You must be logged in to vote 💡 
- 
  You must be logged in to vote 💡 Proposal for OpenAPI Extension: x-sensitive-dataregistriesRelated to any or all spec.openapis.org-hosted registries 
- 
  You must be logged in to vote 💡 3.3: allowmetadataopenapifield to just specify MAJOR.MINOR and omit the PATCH numbertags, info, license, contact, markdown usage, etc. 
- 
  You must be logged in to vote 💡 
- 
  You must be logged in to vote 💡 
- 
  You must be logged in to vote 💡 Security: Add optional client_id attribute to OAuth2security security: authAuthentication including overlap with authorization 
- 
  You must be logged in to vote 💡 Support oauth 2.0 token exchange (RFC 8693)security security: authAuthentication including overlap with authorization 
- 
  You must be logged in to vote 💡 Formalize Webhooks Subscribe/Unsubscribequestion httpSupporting HTTP features and interactions 
- 
  You must be logged in to vote 💡 Add DateTime and Time without TimeZoneformat-registry registriesRelated to any or all spec.openapis.org-hosted registries 
- 
  You must be logged in to vote 💡 Add example(s) to securitySchemes:security example obj/keywordsIssues with the Example Object or exampel(s) keywords security: configThe mechanics of severs and structure of security-related objects 
- 
  You must be logged in to vote 💡 
- 
  You must be logged in to vote 💡 Should OpenAPI highlight the possibility of using the data URL scheme for external examples?example obj/keywordsIssues with the Example Object or exampel(s) keywords 
- 
  You must be logged in to vote 💡 Introduction of message traitsre-use: globals/defaultsDefault or global components that can be overridden in some way 
- 
  You must be logged in to vote 💡 Examples referencing other examplesexample obj/keywordsIssues with the Example Object or exampel(s) keywords 
- 
  You must be logged in to vote 💡 Semantic tagging for interoperability (of 3rd party cloud platforms)metadatatags, info, license, contact, markdown usage, etc. ai / llmsIssues related to AI (LLM) use cases 
- 
  You must be logged in to vote 💡 
- 
  You must be logged in to vote 💡 Explicity mention that a media type object can be emptyexamplesrequests for more or better examples in the specification media and encodingIssues regarding media type support and how to encode data (outside of query/path params) 
- 
  You must be logged in to vote 💡 
- 
  You must be logged in to vote 💡 
- 
  You must be logged in to vote 💡 Support for WebTransport over HTTP/3 QUICOAI-scope httpSupporting HTTP features and interactions 
- 
  You must be logged in to vote 💡 No way to describe a path-item with an empty URI pathrequest matchingMatching requests to URL templates, media types, etc. httpSupporting HTTP features and interactions