Power BI Desktop Bridge (Preview)

Power BI Desktop Bridge (Preview)

Power BI Desktop Bridge introduces a new way of working, allowing external applications and agents to interact directly with Power BI Desktop!

What is Power BI Desktop Bridge?

The bridge is a lightweight local server that lets external applications interact directly with Power BI Desktop.

Think of it as a direct, secure channel between your tools and Power BI Desktop. Your agents, scripts, and external applications can now:

• Check the current state of your report.
• Trigger key actions, like reloading files after edits.
• Capture screenshots to validate changes.
• Iterate and improve in real time, without manual handoffs.

The following core capabilities are available through the bridge:

Discover What's Available

• Method: bridge.manifest
• Capabilities: Returns a complete list of all capabilities and their specifications.
  • Think of this as a "menu" of what your version of Desktop can do. Always check this first to see what's available.

Check Report State

• Method: application.state.get/v1
• Capabilities: Returns information about the currently open file and whether there are unsaved changes.
• In plain language: Know which file is open and if there are pending edits. Essential before running automation that might affect your work.

Capture Report Snapshots

• Method: report.snapshot.capture/v1
• Capabilities: Captures a PNG screenshot of a specific report page at any resolution you want.
• In plain language: See exactly how your report looks right now. Perfect for validating changes visually or sharing proof of work.

Reload files from Disk

• Method: file.reload/v1
• Capabilities: Reloads the open PBIP/PBIR file from disk to pick up on-disk edits.
• In plain language: After making changes to report files, refresh Desktop to see them. You can control whether the semantic model is also reloaded.

Why this is a big step for agents?

Before the bridge, agents could be incredibly smart about generating code and automating repetitive tasks. But they hit a wall: they couldn't talk directly to Power BI Desktop. They couldn't reload files to see changes in real time. They couldn't capture screenshots to validate what they'd built. They were flying blind.

Now, with the bridge, that changes completely, agents can:

1. Read the current report state.
2. Edit report files directly on disk.
3. Reload to see changes instantly in Desktop.
4. Validate with a live screenshot.
5. Iterate immediately—observing, learning, and improving.

Ready to see this in action? The Report Authoring Skill is a perfect example. It leverages the bridge to read state, make edits, reload instantly, validate visually with screenshots, and iterate continuously in one seamless loop. Now, reports that would take hours to build, debug, and refine manually can now be authored, validated, and polished by agents in minutes.

But this is just the beginning. The bridge opens the door for you to build the custom solutions you need.

How to get started

Desktop Bridge is enabled by default. To disable or enable it:

1. Open Power BI Desktop.
2. Go to File > Options and settings > Options.
3. Open Preview features.
4. Enable external tool access to Power BI Desktop through secure local APIs.

Screenshot of Power BI Desktop Options window under Preview features, highlighting the setting “Enable external tool access to Power BI Desktop through secure local APIs

Start using the Desktop Bridge

The easiest way to start is with the Power BI Desktop Bridge CLI. It lets you leverage the bridge in a simple, practical way, without building custom integrations first. Built on top of the bridge, it includes a set of intuitive commands ready to use.

The reload command is a great example. If you are making external changes to your PBIR files, you can simply run:
powerbi-desktop reload

This command reloads your on-disk changes in Power BI Desktop through the bridge, so you can keep iterating without closing and reopening Desktop.

The following are other useful commands at your fingertips:
# See what the bridge can do
powerbi-desktop manifest

# Check which Desktop instances are running
powerbi-desktop status

# Reload after making edits
powerbi-desktop reload

# Capture screenshots of every report page
powerbi-desktop screenshot-all 

Ready to try it?

The Desktop Bridge is here, and it's ready to transform how you work with Power BI Desktop. Stop waiting for manual steps. Start automating.

Get started now: Power BI Desktop Bridge.