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 open issues indexed

Open Community (TDC) Meeting, Thursday 24 September 2026 Open

Housekeeping

Difficulty 1/5 Under an hour Newbie friendliness 15/100

OAI/OpenAPI-Specification#5554 · Opened Sep 17, 2026
Open Community (TDC) Meeting, Thursday 17 September 2026 Open

Housekeeping

Difficulty 1/5 Under an hour Newbie friendliness 25/100

OAI/OpenAPI-Specification#5542 · 8 comments · Opened Sep 10, 2026
Open Community (TDC) Meeting, Thursday 10 September 2026 Open

Housekeeping

Difficulty 1/5 Under an hour Newbie friendliness 25/100

OAI/OpenAPI-Specification#5532 · 4 comments · Opened Sep 3, 2026
v3.2.1 release Open

OAI/OpenAPI-Specification#5460 · 11 comments · 1 reaction · 1 assignee · Opened Aug 1, 2026
v3.3: Allow `in: query` and `in: querystring` and/or multiple `in: querystring`s together? Open

param serialization

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

OAI/OpenAPI-Specification#5366 · 12 comments · Opened Jun 5, 2026
Open Community (TDC) Meeting, Thursday 28 May 2026 Open

Housekeeping

Difficulty 1/5 Under an hour Newbie friendliness 25/100

OAI/OpenAPI-Specification#5348 · 2 comments · Opened May 21, 2026
Open Community (TDC) Meeting, Thursday 21 May 2026 Open

Housekeeping

Difficulty 1/5 Under an hour Newbie friendliness 35/100

OAI/OpenAPI-Specification#5337 · 2 comments · Opened May 14, 2026
v3.3: Global parameters Open

param serialization re-use: globals/defaults

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

OAI/OpenAPI-Specification#5320 · 1 comment · Opened May 7, 2026
Runtime expression `name` rule inconsistent with path template grammar Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

OAI/OpenAPI-Specification#5285 · 10 comments · 1 reaction · Opened Apr 13, 2026
v3.2: issues with the path-item and server url templates Open

clarification

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

OAI/OpenAPI-Specification#5062 · 20 comments · Opened Oct 24, 2025
v3.0: set up schema maintenance Open

Housekeeping Schema

OAI/OpenAPI-Specification#4986 · 6 comments · 1 assignee · Opened Sep 23, 2025
Create „pass“ test cases from examples in `oas.md` Open

Housekeeping

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

OAI/OpenAPI-Specification#4803 · Opened Jul 19, 2025
Consider additional guidance on Server Objects Open

deployment

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

OAI/OpenAPI-Specification#4542 · Opened Apr 10, 2025
Is it possible to indicate the requiredness of a `multipart/form-data`'s request's `filename` directive? Open

media and encoding param serialization

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

OAI/OpenAPI-Specification#4442 · 10 comments · 1 reaction · Opened Mar 15, 2025
Provide guidance on using OAS with Overlay and Arazzo Open

clarification

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

OAI/OpenAPI-Specification#4221 · 3 comments · Opened Nov 21, 2024
Make the "latest" schema accessible programmatically Open

Schema website

OAI/OpenAPI-Specification#4152 · 12 comments · 1 assignee · Opened Oct 22, 2024
Improve 3.1+ schema `$id` UX Open

Schema

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

OAI/OpenAPI-Specification#4147 · 47 comments · Opened Oct 19, 2024
Link Object (and Arazzo?): require referencing operation with unambiguous path template Open

bug re-use: ref/id resolution

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

OAI/OpenAPI-Specification#4084 · 3 comments · Opened Sep 11, 2024
Add requirements or recommendations about allow/deny lists for reference target retrieval Open

re-use: ref/id resolution security security: meta

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

OAI/OpenAPI-Specification#4037 · 3 comments · Opened Aug 17, 2024
Consolidated $ref-to-Some Object feature request Open

re-use: ref-everywhere

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

OAI/OpenAPI-Specification#3853 · 8 comments · 7 reactions · Opened May 24, 2024
Establish governance docs for working groups Open

Housekeeping Process

OAI/OpenAPI-Specification#3774 · 2 comments · 2 assignees · Opened May 2, 2024
Why does the JSON schema for 3.0 specify patternProperties for component names but allows additional properties? Open

bug Schema

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

OAI/OpenAPI-Specification#3720 · 5 comments · Opened Apr 19, 2024
Proposal: Create new repo for openapi tests, similar to json schema test suite Open

Housekeeping

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

OAI/OpenAPI-Specification#3486 · 3 comments · Opened Jan 3, 2024
TOB info needs to be updated Open

Process

Difficulty 3/5 1-2 days Newbie friendliness 35/100

OAI/OpenAPI-Specification#3482 · 8 comments · Opened Dec 22, 2023
The Response object's `default` field is confusing and inconsistently interpreted Open

clarification re-use: globals/defaults

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

OAI/OpenAPI-Specification#3396 · 9 comments · 1 reaction · Opened Oct 5, 2023
Feature request: standard file that describes what openapi features are supported by an implementation Open

enhancement

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

OAI/OpenAPI-Specification#3247 · 4 comments · Opened Apr 15, 2023
Support for CBOR Open

media and encoding

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

OAI/OpenAPI-Specification#3108 · 15 comments · 11 reactions · Opened Dec 29, 2022
Compose all component types, not just schemas Open

re-use: ref-group-combine

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

OAI/OpenAPI-Specification#2936 · 4 comments · 2 reactions · Opened May 31, 2022
Enhance Response cache-control header Open

headers http param serialization

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

OAI/OpenAPI-Specification#2784 · 5 comments · Opened Nov 9, 2021
Allow definition of immutable values in Schema Object Open

schema-object

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

OAI/OpenAPI-Specification#2720 · 16 comments · 8 reactions · Opened Sep 22, 2021
allowing $ref in descriptions Open

re-use: ref-everywhere

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

OAI/OpenAPI-Specification#2697 · 10 comments · 12 reactions · Opened Sep 3, 2021
Are these OpenAPI 3 paths ambiguous? Open

clarification question request matching

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

OAI/OpenAPI-Specification#2564 · 7 comments · 1 reaction · Opened May 4, 2021
OpenAPI vocabulary or dialect for code generation Open

schema-object

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

OAI/OpenAPI-Specification#2542 · 12 comments · 7 reactions · Opened Apr 15, 2021
Clarification required for templated paths with same hierarchy but different templated names and methods Open

clarification request matching

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

OAI/OpenAPI-Specification#2530 · 1 comment · 1 reaction · Opened Apr 9, 2021
Allow required as sibling of $ref (like summary/description) Open

param serialization re-use: traits/merges

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

OAI/OpenAPI-Specification#2498 · 5 comments · 19 reactions · Opened Mar 10, 2021
How to state parameter requirements in HTTP headers? Open

headers media and encoding

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

OAI/OpenAPI-Specification#2458 · 9 comments · 1 reaction · Opened Feb 12, 2021
`primaryData` attribute in Media Type Object Open

media and encoding

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

OAI/OpenAPI-Specification#2454 · 4 comments · Opened Jan 30, 2021
Add support for templatedRef in Reference Object Open

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

OAI/OpenAPI-Specification#2453 · 6 comments · Opened Jan 30, 2021
JSON Schema path pattern Open

Schema

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

OAI/OpenAPI-Specification#2417 · 4 comments · Opened Dec 3, 2020
Add support for "changelog" in the "info" object Open

metadata

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

OAI/OpenAPI-Specification#2409 · 7 comments · 5 reactions · Opened Nov 13, 2020
npm package not published? Open

Housekeeping Schema

Difficulty 3/5 1-2 days Newbie friendliness 30/100

OAI/OpenAPI-Specification#2400 · 5 comments · Opened Nov 4, 2020
Ordering of matches when no path is concrete Open

clarification request matching

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

OAI/OpenAPI-Specification#2356 · 7 comments · 6 reactions · Opened Sep 21, 2020
Supporting of one separate 'required' option for query parameters Open

param serialization re-use: globals/defaults re-use: traits/merges

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

OAI/OpenAPI-Specification#2347 · 2 comments · 2 reactions · Opened Sep 11, 2020
Parameters for Media Types Open

headers media and encoding request matching

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

OAI/OpenAPI-Specification#2342 · 20 comments · 13 reactions · Opened Sep 6, 2020
Indicate that parameterObject has dynamic enum ? Open

param serialization schema-object

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

OAI/OpenAPI-Specification#2313 · 2 comments · 2 reactions · Opened Aug 13, 2020
[Question] Optional response payloads Open

media and encoding question

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

OAI/OpenAPI-Specification#2236 · 7 comments · 2 reactions · Opened May 19, 2020
Callbacks runtime expressions in multipart bodies Open

links media and encoding question

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

OAI/OpenAPI-Specification#2146 · 4 comments · Opened Feb 18, 2020
More example `same hierarchy` in path templating Open

clarification examples request matching

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

OAI/OpenAPI-Specification#2015 · 1 comment · Opened Sep 25, 2019
Support for structured-headers de/serialization Open

headers param serialization

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

OAI/OpenAPI-Specification#1980 · 21 comments · 1 reaction · Opened Jul 19, 2019
Path Templating with multiple parameters allows for ambiguous parsing Open

clarification request matching

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

OAI/OpenAPI-Specification#1970 · 4 comments · 2 reactions · Opened Jul 8, 2019

OAI/OpenAPI-Specification

Get new issues in your inbox