deployment-pipelines-authoring-cli

Automates Fabric deployment pipelines for ALM promotion across dev, test, and prod stages via REST API.

1.1k|301|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/microsoft/skills-for-fabric --skill deployment-pipelines-authoring-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deployment-pipelines-authoring-cli
Source: https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-skills/skills/deployment-pipelines-authoring-cli
Command: npx skills add https://github.com/microsoft/skills-for-fabric --skill deployment-pipelines-authoring-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Promoting Microsoft Fabric content between development, test, and production environments requires coordinating pipeline stages, workspace assignments, and long-running deploy operations through the Fabric REST API, which is error-prone when done manually from a terminal.

Core Features & Use Cases

  • Pipeline Lifecycle Management: Create, update, and delete deployment pipelines with 2-10 ordered stages, and assign or unassign workspaces to stages.
  • Stage-to-Stage Deployment: Execute forward or backward deploys as long-running operations, poll operation status to completion, and perform selective deploys of specific items.
  • Change Detection: Diff item definitions between stages using a normalization-aware script to deploy only changed items, avoiding false positives from auto-rebound fields.
  • Use Case: A data engineer promotes a validated semantic model and report from the Test stage to Production by resolving stage IDs by name, posting a selective deploy with a note, and polling the operation until it succeeds.

Quick Start

Ask the assistant to promote your Fabric development workspace content to the Test stage and report when the deployment finishes.

Frequently Asked Questions about deployment-pipelines-authoring-cli

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

FAQPage Schema
How do I deploy Fabric items between deployment pipeline stages?

Resolve the source and target stage IDs by listing pipelines and filtering with JMESPath, then POST to /deploymentPipelines/{id}/deploy with the stage IDs and an optional items array. The deploy returns 202 with an operation ID that you poll at /v1/operations/{operationId} until it reaches Succeeded or Failed.

How to deploy only changed items in a Fabric deployment pipeline?

Fabric has no compare API, so list stage items for both stages, pair them by targetItemId, fetch getDefinition for each paired item, and diff them with the included diff_item_definitions.py script. Then submit a selective deploy with only the new and changed items.

What permissions are required for Fabric deployment pipeline operations?

You need the Admin role on the pipeline for all operations, plus workspace roles: Admin on the workspace for assign/unassign, and at least Contributor or Member on both source and target workspaces for deploys. Deploy also requires the Pipeline.Deploy delegated scope.

Why does my Fabric deploy fail with WorkspaceMigrationOperationInProgress?

A pipeline runs only one deployment operation at a time, so starting a second deploy while one is in flight returns this HTTP 400 error. Poll the current operation to a terminal state before starting the next promotion.

Can I create deployment rules through the Fabric REST API?

No, deployment rules and parameter rules are configured only in the Fabric portal UI; there is no REST API to create or read them. Unassigning a workspace also permanently deletes that stage's rules and deployment history.

Does a selective deploy propagate item deletions in Fabric pipelines?

No, a selective deploy with an items array does not remove items deleted from the source stage. Use a full deploy by omitting the items array to propagate deletions, or delete the target item manually.