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

Examples

fabio git status --workspace $WS -o table

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	string	No	Selective commit: comma-separated item object IDs
--workspace-head	string	No	Override workspace head (auto-fetched from status if omitted)
--wait	bool	No	Wait for the operation to complete
--timeout	string	No	Timeout in seconds when –wait is used (default: 120)

Examples

fabio git commit --workspace $WS --message "feat: add sales pipeline" --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
--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	string	No	Timeout in seconds when –wait is used (default: 120)

Examples

fabio git pull --workspace $WS --strategy prefer-remote --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

Examples

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

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	string	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	string	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	string	No	Timeout in seconds when –wait is used (default: 120)

Mutates state · Returns object

connection

Show or manage Git connection and credentials

fabio git connection

Read-only · 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