(#22356) Add api documentation for reports - REVIEW ONLY

FOR REVIEW ONLY - DO NOT MERGE THIS VERSION

This adds a draft of documentation for the reports "REST" api.

This version is a DRAFT with lots of questions.