OAI/OpenAPI-Specification

View on GitHub

The OpenAPI Specification Repository

Stars: 31.2k
Forks: 9.2k
Open beginner issues: 0
Indexed issues: 68
Avg merge: 6h 37m
Merged PRs (30d): 27

Dominant language: Markdown
License: Apache-2.0
Last GitHub push: Sep 11, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

68 issues indexed so far

Support multiple contacts in info object Open

metadata

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/OpenAPI-Specification#1589 · 8 comments · 6 reactions · Opened May 23, 2018
Hypermedia and path variable Open

links

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#1553 · 17 comments · Opened Apr 19, 2018
Extensible enumerations (growable lists) Open

schema-object

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#1552 · 33 comments · 24 reactions · Opened Apr 19, 2018
Formalize conformance test description format Open

OAI/OpenAPI-Specification#1520 · 5 comments · 1 assignee · Opened Apr 2, 2018
Vary presence and requirement of properties with CRUD operation Open

schema-object

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#1497 · 21 comments · 10 reactions · Opened Mar 1, 2018
Components fields name too restrictive? Open

clarification examples

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#1387 · 2 comments · 1 reaction · Opened Oct 23, 2017
Is it possible to group parameters ? Open

re-use: ref-group-combine

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#1364 · 3 comments · Opened Oct 4, 2017
Inconsistency in runtime expression examples for request headers Open

clarification

Difficulty 4/5 3-5 days Newbie friendliness 28/100

OAI/OpenAPI-Specification#1323 · 2 comments · Opened Aug 17, 2017
Permit multiple externalDocs Open

enhancement metadata re-use: ref-group-combine

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#1034 · 19 comments · 49 reactions · Opened Apr 11, 2017
Proposal: Having an example for an entire operation in one place (request + response) Open

example obj/keywords

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#859 · 5 comments · 2 reactions · Opened Dec 23, 2016
Proposal: Support for HTTP compression Open

headers http OAI-scope

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#738 · 14 comments · 16 reactions · Opened Jul 18, 2016
Clarification on the purpose of the API license? Open

clarification editorial review

OAI/OpenAPI-Specification#726 · 18 comments · 9 reactions · 1 assignee · Opened Jul 7, 2016
Structural improvements: enhance headers handling Open

headers re-use: globals/defaults

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#690 · 18 comments · 39 reactions · Opened May 11, 2016
Add default responses Open

re-use: globals/defaults

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/OpenAPI-Specification#563 · 27 comments · 60 reactions · Opened Feb 10, 2016
Adding optional SLA definitions with the Spec Open

metadata

Difficulty 5/5 Over a week Newbie friendliness 20/100

OAI/OpenAPI-Specification#541 · 12 comments · 5 reactions · Opened Jan 15, 2016
No provision to group API's and then $ref it to reference it in other file Open

re-use: ref-group-combine

Difficulty 5/5 Over a week Newbie friendliness 25/100

OAI/OpenAPI-Specification#508 · 5 comments · Opened Nov 14, 2015
Share header with multiple response objects Open

re-use: globals/defaults

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/OpenAPI-Specification#369 · 13 comments · 13 reactions · Opened May 19, 2015
Allow for overloading/aliasing of route path Open

request matching versioning

Difficulty 5/5 Over a week Newbie friendliness 35/100

OAI/OpenAPI-Specification#213 · 36 comments · 8 reactions · Opened Nov 19, 2014

OAI/OpenAPI-Specification

Get new issues in your inbox