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.

View Source Code

Explore the Bitbucket connector implementation

Authentication

This connector uses a custom authentication configuration.

Authentication Configuration

Bitbucket authentication credentials schema.

Requires API token authentication with Atlassian email.

access_token

strRequired

Create a Bitbucket API token here with scopes:

account
read:user:bitbucket
read:workspace:bitbucket
read:repository:bitbucket

When using this, also provide your Atlassian email address.

strRequired

Your Atlassian email address (required for API token authentication)

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.

Configuration Options

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.

Data Models

The following data models are available for this connector:

BitbucketWorkspaceEntity

Schema for Bitbucket workspace entity.

Reference: https://developer.atlassian.com/cloud/bitbucket/rest/api-group-workspaces/

Field	Type	Description
slug	str	Workspace slug identifier
uuid	str	Workspace UUID
is_private	bool	Whether the workspace is private
url	Optional[str]	URL to view the workspace

BitbucketRepositoryEntity

Schema for Bitbucket repository entity.

Reference: https://developer.atlassian.com/cloud/bitbucket/rest/api-group-repositories/

Field	Type	Description
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
size	Optional[int]	Size of the repository in bytes
mainbranch	Optional[str]	Main branch name
workspace_slug	str	Slug of the parent workspace
url	Optional[str]	URL to view the repository

BitbucketDirectoryEntity

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
url	Optional[str]	URL to view the directory

BitbucketCodeFileEntity

Schema for Bitbucket code file entity.

Reference: https://developer.atlassian.com/cloud/bitbucket/rest/api-group-source/

Field	Type	Description
commit_hash	Optional[str]	Commit hash of the file version
repo_slug	str	Slug of the repository
repo_full_name	str	Full name of the repository
workspace_slug	str	Slug of the workspace
line_count	Optional[int]	Number of lines in the file