continuing from #990 (comment)
Anywhere we document an apiResponse argument, we should be able to link it to the API docs that show what the user can expect from that object.
Tip: for most of the API docs I've seen, you can append a fragment #response to the URL to deep link to the relevant section.