Power BI REST API documentation: tag current\future capabilities

The Power BI REST API documentation for GetReportsAsAdmin states:

"Below is a list of properties that may be returned for a report. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database."

• https://docs.microsoft.com/en-us/rest/api/power-bi/admin/reports-get-reports-as-admin

Microsoft Power BI Support confirmed that this API is not currently capable of returning even basic properties such as the Report Description and Endorsement details.  This is the case when using a Service Principal with full read acces to all Power BI objects and Tenant.Read.All permissions on the Tenant. 



I suspect that it's a similar situation for other API's in this suite and would like Microsoft to update the documentation to clearly:

• identify properties that are currently available


• identify properties that will be available in the future - including a possible release date


• articulate under what circumstances "a subset of properties" are returned

This would bring much needed clarity and save time for developers in the future.