marshmallow-code/apispec

View on GitHub

A pluggable API specification generator. Currently supports the OpenAPI Specification (f.k.a. the Swagger specification)..

Stars: 1.2k
Forks: 202
Open beginner issues: 0
Indexed issues: 29
Avg merge: 3h 38m
Merged PRs (30d): 3

Dominant language: Python
License: MIT
Last GitHub push: Sep 7, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

29 open issues indexed

DateTime(format="timestamp") generates invalid OpenAPI schema using min instead of minimum Open

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

marshmallow-code/apispec#1064 · Opened Jul 30, 2026
Dependency Dashboard Open

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

marshmallow-code/apispec#1033 · Opened Apr 14, 2026
`apispec` ignores `oneOf` from `marshmallow-oneofschema` Open

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

marshmallow-code/apispec#1012 · 6 comments · Opened Feb 12, 2026
Support Overlays standard Open

enhancement

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

marshmallow-code/apispec#981 · 2 comments · Opened Jun 11, 2025
Date and DateTime with format argument not rendered correctly Open

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

marshmallow-code/apispec#938 · 1 reaction · Opened Sep 2, 2024
Document "content" parameters Open

backwards incompat feedback welcome

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

marshmallow-code/apispec#922 · Opened Jul 10, 2024
Add requestBody component Open

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

marshmallow-code/apispec#886 · 14 comments · 1 reaction · Opened Feb 15, 2024
Document form data and images Open

question

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

marshmallow-code/apispec#874 · Opened Jan 10, 2024
Interest in taking Schema description from Schema.__doc__ docstring Open

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

marshmallow-code/apispec#861 · Opened Sep 30, 2023
Incorrect handling of Union types Open

question

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

marshmallow-code/apispec#837 · 7 comments · Opened May 4, 2023
wrong default value for 'name' in schema2parameters Open

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

marshmallow-code/apispec#829 · 3 comments · Opened Mar 7, 2023
Issue with nested self-referencing schemas Open

question

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

marshmallow-code/apispec#813 · 3 comments · Opened Nov 25, 2022
Multiple schemas for same nested type in data class with marshmallow-dataclass > 8.5.3 Open

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

marshmallow-code/apispec#762 · 2 comments · Opened Apr 28, 2022
Documentation to explitly specify how to serve Swagger UI using apisec ? Open

documentation

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

marshmallow-code/apispec#750 · 1 comment · 5 reactions · Opened Feb 27, 2022
Doubled references for schemas combined with oneOf, anyOf, allOf Open

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

marshmallow-code/apispec#731 · 1 comment · Opened Nov 18, 2021
Docs via Python code Open

question

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

marshmallow-code/apispec#722 · 8 comments · 3 reactions · Opened Oct 13, 2021
Allow user-defined field types to implement their own attribute function Open

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

marshmallow-code/apispec#715 · 2 comments · 1 reaction · Opened Sep 24, 2021
Generating labels of validate.OneOf(labels=[..]) in the json schema Open

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

marshmallow-code/apispec#679 · 3 comments · 1 reaction · Opened Jun 15, 2021
Load operations from reStructedText Open

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

marshmallow-code/apispec#640 · 1 comment · 1 reaction · Opened Mar 1, 2021
What is the best way to handle post_dump hooks and "tweak" the generated spec? Open

question

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

marshmallow-code/apispec#613 · 4 comments · 3 reactions · Opened Nov 24, 2020
Marshmallow’s Nested fields with a restricted schema steal the full schema’s registry spot Open

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

marshmallow-code/apispec#591 · 14 comments · Opened Aug 10, 2020
What to do about multiple nested schemas warning? Open

question

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

marshmallow-code/apispec#444 · 10 comments · Opened May 3, 2019
Add minimum/maximum on date/datetime fields Open

help wanted

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

marshmallow-code/apispec#440 · Opened Apr 29, 2019
Add support for Marshmallow Tuple field Open

help wanted

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

marshmallow-code/apispec#399 · 6 comments · 2 reactions · Opened Feb 28, 2019
Support nested schema inside object properties Open

question

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

marshmallow-code/apispec#379 · 3 comments · Opened Feb 3, 2019
Metadata for Schema Open

feedback welcome

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

marshmallow-code/apispec#337 · 4 comments · Opened Nov 6, 2018
Create methods to register all component objects Open

help wanted

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

marshmallow-code/apispec#245 · 6 comments · Opened Jul 16, 2018
Minor issues with field2choices Open

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

marshmallow-code/apispec#198 · Opened Apr 9, 2018
Support for plugins to add multiple paths at once Open

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

marshmallow-code/apispec#126 · 1 comment · 1 reaction · Opened May 9, 2017

marshmallow-code/apispec

Get new issues in your inbox