python - How to add description to OpenAPI schema using FastApi Dependencies

Question

Is there a way to add field description to FastAPI swagger schema if I use dependency system?

I see no place to add descriptions in simple example from FastAPI docs

async def common_parameters(q: str = None, skip: int = 0, limit: int = 100):
    return {"q": q, "skip": skip, "limit": limit} 

question from:https://stackoverflow.com/questions/65926628/how-to-add-description-to-openapi-schema-using-fastapi-dependencies

Answer 1

You can add description using Query or Body depends on your use case.

from typing import Optional

from fastapi import FastAPI, Query

app = FastAPI()


@app.get("/dummy")
async def dummy(q: Optional[str] = Query(None, description="My description")):
    ...

You can add even more metadata, see the documentation.