That was... perfect.

-> You send us X

<- We give you Y

Why is it so many api docs fail on this basic level?