Request: Visual‑level REST API for report visuals and visual header metadata

[9953512648]

Problem Statement / Summary

Today, Power BI REST APIs provide metadata at the report, page, dataset, and workspace levels, but there is no supported REST API to retrieve visual‑level metadata (for example, visuals on a page, their types, IDs, or visual header settings).

This creates a gap for org‑level governance, compliance, and automated validation, especially for non‑interactive, backend scenarios.

Current State (What Exists Today)

We currently rely on APIs such as:

GET https://api.powerbi.com/v1.0/myorg/reports/{reportId}

GET https://api.powerbi.com/v1.0/myorg/reports/{reportId}/pages

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/pages

These APIs:

• Return report‑level and page‑level metadata
• Do not expose:
  • Visual IDs
  • Visual types
  • Visual positions/layout
  • Visual header configuration (enabled/disabled actions)
  • Per‑visual settings required for validation

There is no REST API equivalent of visual inspection.

Requested Capability (Proposed API)

We request a Visual‑level REST API that exposes metadata for visuals within a report page.
GET https://api.powerbi.com/v1.0/myorg/reports/{reportId}/pages/{pageName}/visuals

This request is not about visualization rendering, but about metadata access for automation and governance.

A visual‑level REST API would complete the existing Power BI metadata surface and unlock critical enterprise scenarios that are currently not possible.