dataflows-save-as-authoring-cli

Migrate Power BI Gen1 dataflows to Gen2.1 via CLI-based REST API calls.

14|3|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/patrikborosch/AnalyticsPlatformAgents --skill dataflows-save-as-authoring-cli-patrikborosch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dataflows-save-as-authoring-cli
Source: https://github.com/patrikborosch/AnalyticsPlatformAgents/tree/main/creator/skills/dataflows-save-as-authoring-cli
Command: npx skills add https://github.com/patrikborosch/AnalyticsPlatformAgents --skill dataflows-save-as-authoring-cli-patrikborosch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Legacy Power BI Gen1 dataflows cannot be migrated in-place to Gen2.1, and manual upgrades risk breaking dependencies, losing data, or encountering storage and permission errors that disrupt analytics workflows.

Core Features & Use Cases

  • Gen1 Dataflow Discovery: Scan individual workspaces or entire tenants to inventory all Gen1 dataflows using Power BI REST and Fabric APIs.
  • 7-Point Risk Assessment: Evaluate each Gen1 dataflow for blockers like BYOSA custom storage, DirectQuery connections, and insufficient permissions, plus warnings like incremental refresh policies and pipeline dependencies.
  • Guarded Save-As Execution: Run the saveAsNativeArtifact API via CLI to create Gen2.1 copies of Gen1 dataflows only after passing readiness checks, with built-in guardrails for Windows compatibility, idempotency, and error handling.
  • Use Case: A data engineer can scan their entire tenant for Gen1 dataflows, identify which are blocked by customer-managed storage, and safely migrate only compatible ones to Gen2.1 while preserving original Gen1 artifacts.

Quick Start

Use the dataflows-save-as-authoring-cli skill to scan your Sales workspace for Gen1 dataflows and generate a full readiness snapshot of all migration candidates.

Frequently Asked Questions about dataflows-save-as-authoring-cli

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

FAQPage Schema
How do I migrate Power BI Gen1 dataflows to Gen2 safely via CLI?

To migrate Gen1 dataflows safely, use CLI-based REST API calls to run guarded saveAsNativeArtifact operations after passing a 7-point readiness check for storage, dependency, and permission constraints. This generates CI/CD-compatible Gen2.1 artifacts while preserving original dataflows.

What blockers prevent a Gen1 dataflow from migrating to Gen2.1?

Common Gen1 dataflow migration blockers include BYOSA custom storage configurations, DirectQuery connections, and insufficient permissions. The pre-migration risk assessment also flags warnings like incremental refresh policies and pipeline dependencies before executing the saveAs operation.

Can I scan my entire tenant for Gen1 dataflows before starting migration?

Yes, you can scan individual workspaces or an entire tenant to inventory all Gen1 dataflows using Power BI REST and Fabric APIs. This discovery process generates a machine-readable readiness snapshot for audit and CI/CD integration.

Does the Gen1 to Gen2 dataflow migration process support CI/CD pipelines?

Yes, the migration process outputs CI/CD-compatible artifacts and machine-readable readiness snapshots. It executes idempotent saveAsNativeArtifact API calls via CLI, ensuring automated dataflow lifecycle management integrates seamlessly with existing pipelines.

What happens if a dataflow fails the pre-migration risk assessment?

If a dataflow fails the pre-migration risk assessment, the guarded execution prevents the saveAsNativeArtifact operation from running. This ensures only compatible dataflows are migrated to Gen2.1, avoiding broken dependencies or data loss.

Are original Gen1 dataflows deleted after migrating to Gen2.1?

No, original Gen1 dataflows are preserved during migration. The CLI-based guarded execution creates Gen2.1 copies using the saveAsNativeArtifact operation, ensuring your legacy dataflows remain intact in case of rollback or audit requirements.