[QUESTION] "Examples" empty select box in Swagger UI doc

I run the sample notes app of the tutorial.

Opening the API documentation with Swagger UI, I found an empty select box labeled “Examples” in Request body block as images below.

What is this select box? What is this use? How can I set a value in the select box?

Try it out button Clicked

[tiangolo]

There’s a new section in the docs with this: https://fastapi.tiangolo.com/tutorial/schema-extra-example/ 🎉

[dmontagu]

Oh man, this looks like it could be really useful as a way to quickly convey/grasp how a given endpoint should be used (especially if the endpoint has a complex or deeply/variably-nested input model).

@tiangolo if https://github.com/samuelcolvin/pydantic/pull/663 makes it possible to easily add examples that can be selected in this drop down, I think that will be worth a specific call-out in the fastapi docs!