Bitbucket

Configuration

Bitbucket source connector integrates with the Bitbucket REST API to extract data.

Connects to your Bitbucket workspaces and repositories.

It supports syncing workspaces, repositories, directories, and code files with configurable filtering options for branches and file types.

Explore the Bitbucket connector implementation

This connector uses a custom authentication configuration.

Authentication Configuration

Bitbucket authentication credentials schema.

username

strRequired

Your Bitbucket username

app_password

strRequired

Bitbucket app password with repository read permissions

workspace

strRequired

Bitbucket workspace slug (e.g., ‘my-workspace’)

repo_slug

Optional[str]

Specific repository to sync (e.g., ‘my-repo’). If empty, syncs all repositories in the workspace.

The following configuration options are available for this connector:

Configuration Parameters

Bitbucket configuration schema.

branch

str

Specific branch to sync (e.g., ‘main’, ‘develop’). If empty, uses the default branch.

file_extensions

list[str]Defaults to []

List of file extensions to include (e.g., ‘.py’, ‘.js’, ‘.md’). If empty, includes all text files. Use ’.*’ to include all files.

The following data models are available for this connector:

Schema for Bitbucket workspace entity.

Field	Type	Description
slug	str	Workspace slug identifier
name	str	Workspace display name
uuid	str	Workspace UUID
is_private	bool	Whether the workspace is private
created_on	Optional[datetime]	Creation timestamp

Schema for Bitbucket repository entity.

Field	Type	Description
name	str	Repository name
slug	str	Repository slug
full_name	str	Full repository name including workspace
description	Optional[str]	Repository description
is_private	bool	Whether the repository is private
fork_policy	Optional[str]	Fork policy of the repository
language	Optional[str]	Primary language of the repository
created_on	datetime	Creation timestamp
updated_on	datetime	Last update timestamp
size	Optional[int]	Size of the repository in bytes
mainbranch	Optional[str]	Main branch name
workspace_slug	str	Slug of the parent workspace

Schema for Bitbucket directory entity.

Field	Type	Description
path	str	Path of the directory within the repository
repo_slug	str	Slug of the repository containing this directory
repo_full_name	str	Full name of the repository
workspace_slug	str	Slug of the workspace

Schema for Bitbucket code file entity.

Field	Type	Description
commit_hash	Optional[str]	Commit hash of the file version
path	str	Path of the file within the repository
repo_slug	str	Slug of the repository
repo_full_name	str	Full name of the repository
workspace_slug	str	Slug of the workspace