Update OpenAPI doc for request bodies (#33891)

* Update OpenAPI doc for request bodies
* Apply suggestions from PR review
* Fix all links to non-attributes to use xref
* A few more little fixes

Co-authored-by: Safia Abdalla <[email protected]>
Co-authored-by: Tom Dykstra <[email protected]>

Author: 3 people