It is helpful to provide a description for request bodies, providing a simple explanation of what can be configured as part of the request payload
OpenAPI Request Bodies Description Info
Message: Request Bodies Have a Description
Policies
Request Bodies
Request bodies are one of the most complex parts of an API to get right. Descriptions, required fields, content types, and validation all need to be present and consistent.