Skip to content

Desktop Bridge unavailable on Power BI Desktop 2.154 — "secure local APIs" preview feature missing; docs lack required Desktop version #33

Description

@arielelevy

Summary

The powerbi-desktop Desktop Bridge CLI (@microsoft/powerbi-desktop-bridge-cli) cannot connect on Power BI Desktop 2.154.1260.0. status always returns not_connected and the named pipe pbi-desktop-bridge-<pid> is never created — so reload/screenshot (the visual-verification loop the powerbi-report-authoring skill depends on) are unusable.

The skill docs say to enable a preview feature, but that checkbox is not present in this build, and the docs do not state the minimum Power BI Desktop version/channel required.

Environment (observed)

  • Power BI Desktop: 2.154.1260.0. The Microsoft Store build and the downloadable MSI (PBIDesktopSetup_x64.exe, listed as 2.154.1260.0, 636.6 MB, published 2026-05-29) are the same version.
  • OS: Windows 11
  • @microsoft/powerbi-desktop-bridge-cli: 0.1.1
  • @microsoft/powerbi-report-authoring-cli: 0.1.1 — works: generates and validates PBIR (result: succeeded).
  • Node: v22

What the docs say

plugins/powerbi-authoring/skills/powerbi-report-authoring/references/powerbi-desktop.md (NO_BRIDGE row):

In Desktop, open File > Options and settings > Options > Preview features, enable Enable external tool access to Power BI Desktop through secure local APIs, restart Desktop, then retry powerbi-desktop status.

Observed behavior (facts, not inference)

  1. Options > Preview features does not list a checkbox named "Enable external tool access to Power BI Desktop through secure local APIs" on this build.
  2. With a PBIP report open in Desktop, powerbi-desktop status returns {"status":"not_connected","instances":[]}.
  3. Enumerating every named pipe on the machine returns no pbi-desktop-bridge-* pipe.
  4. powerbi-desktop open <pbip> (with PBI_DESKTOP_PATH set to the real PBIDesktop.exe) launches Desktop but the returned bridgeStatus is still not_connected.

I am not asserting the root cause. These are the reproducible observations.

Request

Please document, in the report-authoring skill and/or the Learn page (https://aka.ms/Report_Authoring_skill_LearnDocs):

  1. The minimum Power BI Desktop version that ships the Desktop Bridge host / the "secure local APIs" feature.
  2. The release channel required (GA vs Insiders/preview), if any.
  3. Whether the Microsoft Store build is supported or only the standalone installer.
  4. A precise pre-flight check (e.g., "if Options > Preview features does not list this toggle, the Desktop build does not support the bridge — update to version X.YYY or later").

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions