Body parameters description?

[thelinuxlich]

Sometimes I miss the possibility of adding a description for each parameter in POST/PUT/DELETE requests instead of having just a body description, am I wrong?

[ecyrbe]

what do you mean ? parameters have description available, so does body, see documentation : http://www.zodios.org/docs/api/api-definition#parameters

[thelinuxlich]

Isn't the body schema defined in a single parameter though?

[ecyrbe]

oh, you mean body properties ? it's a zod feature you are asking for ?

[thelinuxlich]

It's because in OpenAPI the schema fields can have description, no matter if it's a requestBody

[thelinuxlich]

Now thinking more about it, would be nice if the body supported passing a example

[ecyrbe]

It's possible to add an optionnal example field, like for description. it will then allow for openapi example generation. Feel free to create a feature request with a detailed explanation.

But description for schema properties is not possible. it's out of my power to add this feature to zod. So i'm closing this one

[thelinuxlich]

For reference: ecyrbe/zodios-openapi#172