swagger-api/swagger.io-docs

View on GitHub

The content of swagger.io

Stars: 1.6k
Forks: 407
Open beginner issues: 0
Indexed issues: 52
Avg merge: 2m
Merged PRs (30d): 2

Dominant language: Astro
License: No license data
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

52 open issues indexed

error on parameter serialization page Open

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

swagger-api/swagger.io-docs#440 · Opened Mar 5, 2026
Mobile experience feedback Open

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

swagger-api/swagger.io-docs#407 · Opened Oct 10, 2025
Misuse of "URI" in definition of $ref Open

triaged

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

swagger-api/swagger.io-docs#399 · 3 comments · Opened Jun 21, 2025
/employees example in "Media Types" summary inaccurately describes response schema Open

docs triaged

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

swagger-api/swagger.io-docs#398 · Opened Jun 20, 2025
suggested supplement to docs on polymorphism Open

triaged

Difficulty 1/5 1-3 hours Newbie friendliness 45/100

swagger-api/swagger.io-docs#388 · 1 comment · Opened Feb 25, 2025
403 `Sorry, you have been blocked` in Russia Open

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

swagger-api/swagger.io-docs#387 · 2 comments · Opened Feb 14, 2025
Typo in Data Types documentation Open

triaged

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

swagger-api/swagger.io-docs#352 · 1 comment · Opened Aug 10, 2024
"Response That Returns a File" example for base64 uses format: byte Open

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

swagger-api/swagger.io-docs#351 · Opened Jun 13, 2024
'Inheritance and Polymorphism' examples, discriminator usage Open

triaged

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

swagger-api/swagger.io-docs#348 · 2 comments · Opened May 15, 2024
Syntax issues with callback examples Open

triaged

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

swagger-api/swagger.io-docs#345 · 1 comment · Opened Mar 17, 2024
Wrong indentation in 'Inheritance and Polymorphism' example Open

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

swagger-api/swagger.io-docs#343 · Opened Feb 16, 2024
java.lang.NumberFormatException: For input string: "null" in version 1.6.1 Open

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

swagger-api/swagger.io-docs#341 · Opened Oct 20, 2023
error in "Parameter Serialization" page for spaceDelimited, pipeDelimited styles Open

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

swagger-api/swagger.io-docs#339 · 2 comments · 1 reaction · Opened Oct 5, 2023
Typo: allOf not oneOf Open

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

swagger-api/swagger.io-docs#337 · 1 reaction · Opened Jul 25, 2023
Typo: request body 👉 response body in Links document Open

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

swagger-api/swagger.io-docs#336 · Opened Jul 16, 2023
The reference URL doen't work Open

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

swagger-api/swagger.io-docs#335 · Opened Jul 7, 2023
You need to document TAG usage in both 2.0 and 3.0 specs Open

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

swagger-api/swagger.io-docs#334 · Opened Jun 22, 2023
documentation at odds with behavior Open

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

swagger-api/swagger.io-docs#333 · Opened Jun 9, 2023
missing file object in yaml spec for upload file specs Open

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

swagger-api/swagger.io-docs#332 · 1 comment · Opened Apr 17, 2023
Link Did not find what you were looking for? https://community.smartbear.com/t5/Swagger-Open-Source-Tools/bd-p/SwaggerOSTools Open

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

swagger-api/swagger.io-docs#331 · Opened Apr 13, 2023
Description not correct in example - runtime-expressions Open

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

swagger-api/swagger.io-docs#328 · Opened Feb 25, 2023
Enhance card in landing page Open

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

swagger-api/swagger.io-docs#325 · 2 comments · Opened Oct 21, 2022
Multiple Authentication "OR" case not working correctly Open

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

swagger-api/swagger.io-docs#324 · 1 comment · Opened Oct 13, 2022
3.1.0 specification is missing on the website Open

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

swagger-api/swagger.io-docs#323 · 1 comment · Opened Oct 8, 2022
Invalid syntax in example for `response` property under Reusing Responses section Open

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

swagger-api/swagger.io-docs#321 · Opened Sep 23, 2022
Add section anchors to published pages Open

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

swagger-api/swagger.io-docs#320 · Opened Sep 8, 2022
OAS 3 : allOf specification missing ? Open

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

swagger-api/swagger.io-docs#318 · Opened Jul 8, 2022
Multiple Callbacks section missing to define the other two callback events Open

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

swagger-api/swagger.io-docs#316 · 1 comment · Opened Mar 2, 2022
"Describing parameters" says "Accept" is part of the response when it is not Open

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

swagger-api/swagger.io-docs#307 · 1 comment · Opened Jun 23, 2021
Paths and operations: Query String in Paths and recommendation Open

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

swagger-api/swagger.io-docs#304 · Opened Jun 11, 2021
Not enough padding above headings Open

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

swagger-api/swagger.io-docs#301 · Opened Feb 8, 2021
How to scroll menu? Open

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

swagger-api/swagger.io-docs#291 · 1 comment · Opened Nov 28, 2020
This repository is drastically behind swagger.io Open

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

swagger-api/swagger.io-docs#289 · 2 comments · Opened Oct 29, 2020
codegen release page is ancient Open

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

swagger-api/swagger.io-docs#275 · 1 comment · Opened Apr 8, 2020
Incorrect format specified for type string. Open

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

swagger-api/swagger.io-docs#273 · 3 comments · Opened Mar 4, 2020
Documentation for Docker Configuration Links To 404 Page Open

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

swagger-api/swagger.io-docs#270 · 2 comments · Opened Jan 23, 2020
SSN Example regex is not correct Open

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

swagger-api/swagger.io-docs#264 · Opened Jan 22, 2020
In multiple callbacks section, event names are missing Open

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

swagger-api/swagger.io-docs#263 · 2 reactions · Opened Jan 16, 2020
Documentation Issue - Reusable Common Response Headers via "Components" Open

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

swagger-api/swagger.io-docs#255 · Opened Nov 5, 2019
Possible issue with an example illustrating a point non-ideally Open

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

swagger-api/swagger.io-docs#254 · Opened Oct 23, 2019
Examples of oneOf keyword are incorrect Open

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

swagger-api/swagger.io-docs#253 · 4 comments · 5 reactions · Opened Sep 20, 2019
Non-encoded $ref on https://swagger.io/docs/specification/using-ref/#escape Open

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

swagger-api/swagger.io-docs#250 · 1 comment · 2 reactions · Opened Aug 11, 2019
Is there a way i can change the documentation style ? I even can not see the yaml text,expect I scroll the text with my mouse. Open

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

swagger-api/swagger.io-docs#243 · 7 comments · Opened Apr 24, 2019
Delay on page display for AdBlock users Open

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

swagger-api/swagger.io-docs#233 · Opened Feb 18, 2019
ExternalDocs is not in General info Open

Difficulty 1/5 1-3 hours Newbie friendliness 48/100

swagger-api/swagger.io-docs#232 · 1 comment · Opened Jan 30, 2019
Missing Open Source tools and integrations on main site Open

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

swagger-api/swagger.io-docs#225 · 2 comments · Opened Jun 19, 2018
Query Parameter doc is incorrect Open

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

swagger-api/swagger.io-docs#217 · 4 comments · Opened Apr 7, 2018
Dockerfile doesn't build anything Open

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

swagger-api/swagger.io-docs#183 · 1 comment · Opened Jun 13, 2017
All ids and names are missing in swagger spec html Open

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

swagger-api/swagger.io-docs#104 · 5 comments · Opened Apr 29, 2016
Publish JSON schemas on swagger.io Open

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

swagger-api/swagger.io-docs#48 · 1 reaction · Opened Oct 16, 2015

swagger-api/swagger.io-docs

Get new issues in your inbox