git

Manage Git integration (connect, commit, pull, status)

Authentication scope: fabric

status

Show workspace Git status (changes, conflicts)

fabio git status --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID
--include-files-details	bool	No	Include per-file changes for each changed item

Examples

fabio git status --workspace $WS --include-files-details

Read-only · Returns object

commit

Commit workspace changes to the connected remote branch

fabio git commit --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID
--message	string	No	Commit message (max 300 characters)
--commit-all	bool	No	Commit all pending changes
--items	array	No	Selective commit: comma-separated item object IDs
--file-selection	array	No	Select a file to commit as ITEM_ID=RELATIVE/PATH (repeatable)
--all-files-for-item	array	No	Commit all files for an item in file-level selective mode (repeatable)
--logical-file-selection	array	No	Select a file by logical item ID as LOGICAL_ID=RELATIVE/PATH (repeatable)
--all-files-for-logical-item	array	No	Commit all files for a logical item ID in file-level selective mode (repeatable)
--workspace-head	string	No	Override workspace head (auto-fetched from status if omitted)
--wait	bool	No	Wait for the operation to complete
--timeout	integer	No	Timeout in seconds when –wait is used (default: 120)

Examples

fabio git commit --workspace $WS --commit-all --message "feat: add sales pipeline" --wait

fabio git commit --workspace $WS --file-selection $ITEM=metadata.json --file-selection $ITEM=config/settings.json --wait

fabio git commit --workspace $WS --all-files-for-item $ITEM --wait

Mutates state · Long-running operation · Returns object

pull

Pull remote changes into the workspace (update from Git)

fabio git pull --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID
--conflict-resolution	enum	No	Conflict resolution policy One of: prefer-remote, prefer-workspace.
--allow-override	bool	No	Allow overriding workspace items with incoming changes
--item-options	string	No	Per-item update options as a JSON array keyed by logicalId (inline or @file)
--workspace-head	string	No	Override workspace head (auto-fetched from status if omitted)
--remote-commit-hash	string	No	Override remote commit hash (auto-fetched from status if omitted)
--wait	bool	No	Wait for the operation to complete
--timeout	integer	No	Timeout in seconds when –wait is used (default: 120)

Examples

fabio git pull --workspace $WS --conflict-resolution prefer-remote --wait

fabio git pull --workspace $WS --item-options @item-options.json --wait

Mutates state · Long-running operation · Returns object

connect

Connect a workspace to a Git repository

fabio git connect --workspace <value> --provider <value> --repo <value> --branch <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID
--provider	enum	Yes	Git provider type One of: azure-devops, github.
--repo	string	Yes	Repository name
--branch	string	Yes	Branch name
--org	string	No	Organization name (Azure DevOps only)
--project	string	No	Project name (Azure DevOps only)
--owner	string	No	Owner name (GitHub only)
--directory	string	No	Relative directory path within the repo
--custom-domain	string	No	Custom domain for GitHub Enterprise (ghe.com)
--connection-id	string	No	Connection ID for configured credentials
--additional-branch-changing-roles	enum	No	Additional workspace roles allowed to change the connected branch One of: None, MemberAndContributor.

Examples

fabio git connect --workspace $WS --provider github --owner myorg --repo fabric-project --branch main --directory "/" --connection-id $GIT_CONN

fabio git connect --workspace $WS --provider azure-devops --org $ORG --project $PROJECT --repo $REPO --branch main --additional-branch-changing-roles MemberAndContributor --dry-run

Mutates state · Returns object

disconnect

Disconnect a workspace from Git

fabio git disconnect --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID

Mutates state · Returns void

init

Initialize a workspace Git connection (required after connect)

fabio git init --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID
--strategy	enum	No	Initialization strategy when both sides have content One of: none, prefer-remote, prefer-workspace.
--wait	bool	No	Wait for the operation to complete
--timeout	integer	No	Timeout in seconds when –wait is used (default: 120)

Examples

fabio git init --workspace $WS --strategy prefer-workspace

Mutates state · Long-running operation · Returns object

checkout

Switch to a different branch (disconnect + connect + init)

fabio git checkout --workspace <value> --branch <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID
--branch	string	Yes	Target branch name
--strategy	enum	No	Initialization strategy [default: prefer-remote] One of: none, prefer-remote, prefer-workspace.
--wait	bool	No	Wait for initialization to complete
--timeout	integer	No	Timeout in seconds when –wait is used (default: 120)

Examples

fabio git checkout --workspace $WS --branch feature/new-model --strategy prefer-remote

Mutates state · Long-running operation · Returns object

branch-out

Create a feature workspace from the current branch (branch out)

fabio git branch-out --workspace <value> --branch <value>

Flag	Type	Required	Description
--workspace	string	Yes	Source workspace (already connected to Git integration branch)
--branch	string	Yes	Name of the new feature branch to create
--new-workspace	string	No	Name for the new feature workspace (default: branch name)
--capacity	string	No	Capacity ID for the new workspace
--existing-workspace	string	No	Use an existing workspace instead of creating a new one
--connection-id	string	No	Connection ID for Git credentials (required for GitHub)
--wait	bool	No	Wait for initialization to complete
--timeout	integer	No	Timeout in seconds when –wait is used (default: 120)

Mutates state · Returns object

connection

Legacy alias for connection-show

fabio git connection

Read-only · Returns object

connection-show

Show Git connection details for the workspace

fabio git connection-show --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID

Examples

fabio git connection-show --workspace $WS

Read-only · Returns object

connection-settings-show

Show Git connection settings

fabio git connection-settings-show --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID

Examples

fabio git connection-settings-show --workspace $WS

Read-only · Returns object

connection-settings-update

Update Git connection settings

fabio git connection-settings-update --workspace <value> --additional-branch-changing-roles <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID
--additional-branch-changing-roles	enum	Yes	Additional workspace roles allowed to change the connected branch One of: None, MemberAndContributor.

Examples

fabio git connection-settings-update --workspace $WS --additional-branch-changing-roles MemberAndContributor --dry-run

Mutates state · Returns object

credentials

Manage Git credentials

fabio git credentials

Read-only · Returns object

relation

Manage workspace relations (base/branch links between workspaces, Preview)

fabio git relation

Examples

fabio git relation list --workspace $BRANCH_WS

fabio git relation create --workspace $BRANCH_WS --related-workspace $BASE_WS --relation-type base

fabio git relation delete --workspace $BRANCH_WS --relation-id $RELATION_ID

Mutates state · Returns object

show-tracked

Show tracked items and their Git sync status

fabio git show-tracked --workspace <value>

Flag	Type	Required	Description
--workspace	string	Yes	Workspace ID

Read-only · Returns object