powerbi-report-management

Manage Power BI report items and PBIR definitions in Microsoft Fabric via the REST API.

Updated Jul 14, 2026
One-click install
npx skills add https://github.com/9vantage/skills-for-fabric-clone --skill powerbi-report-management-9vantage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: powerbi-report-management
Source: https://github.com/9vantage/skills-for-fabric-clone/tree/main/plugins/powerbi-authoring/skills/powerbi-report-management
Command: npx skills add https://github.com/9vantage/skills-for-fabric-clone --skill powerbi-report-management-9vantage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing, downloading, updating, and deleting Power BI reports in Microsoft Fabric requires correctly orchestrating the Fabric REST API, including base64-encoded PBIR definition payloads, long-running operation polling, and semantic model binding. This Skill provides the exact az rest commands, guardrails, and workflows to perform the full report CRUD lifecycle without corrupting definitions or creating duplicates. ## Core Features & Use Cases - Full Report CRUD: List, get, create, update, and delete Power BI report items in Fabric workspaces using az rest against the Fabric REST API. - PBIR Definition Transport: Download and upload complete PBIR definitions with base64-encoded parts, LRO polling, and forward-slash path normalization. - Local .pbip Publishing Workflow: Publish a local .pbip project to Fabric, including semantic model resolution, byPath to byConnection rebinding, and binding verification against the target model's TMDL. - Use Case: You have a local SalesDashboard.pbip project and want to publish it to a Fabric workspace. The Skill resolves the workspace, deploys or selects the semantic model, verifies all visual bindings against the model's tables, uploads the PBIR definition, and polls the operation to completion. ## Quick Start Ask the AI to publish your local .pbip report to a named Microsoft Fabric workspace, or to download an existing report's PBIR definition from a workspace for local editing.

Frequently Asked Questions about powerbi-report-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a local .pbip report to Microsoft Fabric?

Resolve the target workspace ID, decide whether to publish the local semantic model or connect to an existing workspace model, then rebind definition.pbir from byPath to byConnection with the resolved semanticModelId. Base64-encode all PBIR parts and POST to the Fabric reports API, polling the long-running operation to completion.

How do I download a Power BI report definition using the Fabric REST API?

Call POST getDefinition with ?format=PBIR on the report using az rest with the Fabric API audience. The call often returns 202 Accepted, so capture the x-ms-operation-id header with --verbose and poll until completion, then base64-decode each definition part to local files.

Does the Fabric API support PBIR-Legacy report format?

No, this workflow only supports the modern PBIR format. Always pass ?format=PBIR on getDefinition, and if a report returns PBIR-Legacy, it cannot be read or updated through this approach.

Why do visuals appear empty after publishing a report to Fabric?

Empty visuals usually mean PBIR entity bindings do not match the target semantic model's table and column names. Download the model's TMDL, compare all Entity, queryRef, and filter references, and remap mismatched bindings before republishing.

Why did duplicate reports appear in my workspace after creating a report?

Duplicates occur when a create POST is retried after receiving a 202 Accepted response, since the operation is already processing server-side. Never retry the POST; instead capture the x-ms-operation-id and poll the operation, then delete any duplicates with the Delete Report API.

What is the difference between report management and report authoring in Power BI?

Report management handles transport: listing, creating, downloading, uploading, and deleting report items and PBIR definitions via the Fabric API. Report authoring handles the PBIR content itself, such as pages, visuals, filters, themes, and formatting, which belongs to the powerbi-report-authoring skill.