deployment-pipelines-authoring-cli

Automate Microsoft Fabric deployment pipelines and stage-to-stage content promotion via the Fabric REST API.

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/paulasilvatech/Fabric-Agentic-SDLC --skill deployment-pipelines-authoring-cli-paulasilvatech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deployment-pipelines-authoring-cli
Source: https://github.com/paulasilvatech/Fabric-Agentic-SDLC/tree/main/.github/skills/deployment-pipelines-authoring-cli
Command: npx skills add https://github.com/paulasilvatech/Fabric-Agentic-SDLC --skill deployment-pipelines-authoring-cli-paulasilvatech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Promoting Microsoft Fabric content across dev, test, and production stages requires many manual portal clicks, and the Fabric REST surface has non-obvious pitfalls: deploys are long-running operations, IDs must be resolved by name, permissions span two systems, and there is no compare API to detect changed items. This Skill drives the entire deployment-pipelines lifecycle from an agentic CLI using az rest and curl. ## Core Features & Use Cases - Pipeline and Stage Lifecycle: Create, update, and delete deployment pipelines with 2-10 ordered stages, and assign or unassign workspaces to stages with idempotent scripting. - Stage-to-Stage Deployment: Deploy all supported items or a selective items list forward or backward, then poll the long-running operation to a terminal state and report per-item results. - Changed-Item Detection: Compute the delta between stages yourself using the bundled diff_item_definitions.py script, which normalizes auto-rebound binding fields so unedited items do not appear changed. - Use Case: A user asks to promote a validated Sales dev workspace to the Test stage. The Skill resolves pipeline, stage, and workspace IDs by name via JMESPath, POSTs the deploy with a note, polls /v1/operations/{id} until completion, and reports which items moved. ## Quick Start Ask the assistant to create a three-stage Fabric deployment pipeline named Sales Analytics ALM and assign your development workspace to its first stage.

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 content between Fabric deployment pipeline stages via REST API?▼

POST to /v1/deploymentPipelines/{id}/deploy with sourceStageId, targetStageId, and an optional items array of { sourceItemId, itemType }. The call returns 202 with an operation ID in the x-ms-operation-id header; poll /v1/operations/{operationId} until the state is Succeeded or Failed.

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

Fabric has no compare API, so list stage items in both stages, pair them by targetItemId, fetch getDefinition for each paired item, and diff with the bundled diff_item_definitions.py script. It normalizes auto-rebound fields like notebookId and workspaceId, then submit a selective deploy with only the changed items.

What permissions are required to assign a workspace or deploy stage content in Fabric?▼

You need the Admin role on the deployment pipeline plus the appropriate workspace role: workspace Admin for assign/unassign, and at least Contributor or Member on both source and target workspaces for deploy. Deploy also requires the Pipeline.Deploy delegated scope, not just Pipeline.ReadWrite.All.

Why does a 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 HTTP 400 with this error. Poll the current operation to a terminal state before starting the next promotion; workspace assignment also fails during an active deployment.

Can I create deployment rules or parameter 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 permanently deletes that stage's rules and deployment history, so record rules before repairing a broken item pairing.

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, and warn users before promoting.