How to provide custom example value for single return

[retnikt]

First check

• I used the GitHub search to find a similar issue and didn't find it.
• I searched the FastAPI documentation, with the integrated search.
• I already searched in Google "How to X in FastAPI" and didn't find any information.

Description

How can I provide a custom example value for the return value of routes? When the return is a Pydantic model, you can set the example keyword argument on a pydantic Field or add it to schema_extra in the Model config. However, when the return value is a simple type such as str or List[Optional[int]]` there seems to be no way to provide an example. Am I missing something, or is this a missing feature?

[phy25]

#1007 (comment)

[retnikt]

@phy25 I am asking about responses not request parameters.

[chris-allnutt]

you can manually extend/alter the returned schema, but I'd think there would be a way to do this
https://fastapi.tiangolo.com/advanced/extending-openapi/

[nkhitrov]

Hi, @retnikt !

You can add examples for in field responses. See this page

[retnikt]

Thanks @SlyFoxy

[tiangolo]

Thanks for the help here everyone! 👏 🙇

Thanks for reporting back and closing the issue @retnikt 👍