The API reference should show the response headers

Rate-limit headers, request ids, and the processing-time header are all in every response, but the reference only documents the body. Half the questions in this forum would be answered by a 'Headers' section.

Strong agree. I learned about x-request-id from this forum, not the docs.

Agreed — this is now on the reference roadmap.