Request body tables aren't as good as they could be

[bourdakos1]

right now we just list the root json and the schema it relies on for example:

Request Body
{ friends: Person[] }

Person
{ name: string }

we should do something like this maybe?

Request Body
friends Person[] A list of friends

Person
name string — REQUIRED The name of the person

Or maybe nested tables?

Request Body
friends Person[] A list of friends name string — REQUIRED The name of the person
firstname string — REQUIRED Your firstname
middle string Your middle initial
lastname string — REQUIRED Your firstname