> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.

# Bitbucket

> Bitbucket integration with Airweave

{/* AUTO-GENERATED CONTENT START */}

<img src="https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/airweave.docs.buildwithfern.com/2026-05-20T11%3A36%3A51.367Z/docs/pages/connectors/bitbucket/icon.svg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260807%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260807T163035Z&X-Amz-Expires=604800&X-Amz-Signature=5e363c6e66890edfc2283ba59fe9ddcecab86f0716beb3eb35bf6aca6b45b189&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject" alt="Bitbucket logo" width="48" height="48" />

<h1>
  Bitbucket
</h1>

This connector enables AI agents and RAG systems to retrieve context from Bitbucket through Airweave's unified search layer.

## 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](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/bitbucket.py)

Explore the Bitbucket connector implementation

### Authentication

**Supported authentication methods:**

* Direct Credentials
* Auth Provider

### Configuration Options

This connector does not have any additional configuration options.

## Data Models

The following data models are available for this connector:

#### BitbucketWorkspaceEntity

Schema for Bitbucket workspace entity.

| Field         | Type                | Description                      |
| ------------- | ------------------- | -------------------------------- |
| uuid          | str                 | Workspace UUID                   |
| display\_name | str                 | Display name of the workspace    |
| created\_on   | Optional\[datetime] | Workspace creation timestamp     |
| slug          | str                 | Workspace slug identifier        |
| is\_private   | bool                | Whether the workspace is private |
| html\_url     | Optional\[str]      | URL to view the workspace        |

#### BitbucketRepositoryEntity

Schema for Bitbucket repository entity.

| Field           | Type           | Description                              |
| --------------- | -------------- | ---------------------------------------- |
| uuid            | str            | Repository UUID                          |
| repo\_name      | str            | Repository display name                  |
| created\_on     | datetime       | Repository creation timestamp            |
| updated\_on     | datetime       | Last update timestamp                    |
| 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             |
| html\_url       | Optional\[str] | URL to view the repository               |

#### BitbucketDirectoryEntity

Schema for Bitbucket directory entity.

| Field            | Type           | Description                                      |
| ---------------- | -------------- | ------------------------------------------------ |
| path\_id         | str            | Unique identifier for the directory path         |
| directory\_name  | str            | Display name of the directory                    |
| path             | str            | Path of the directory within the repository      |
| branch           | Optional\[str] | Branch for this directory view                   |
| 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                            |
| html\_url        | Optional\[str] | URL to view the directory                        |

#### BitbucketCodeFileEntity

Schema for Bitbucket code file entity.

| Field            | Type           | Description                         |
| ---------------- | -------------- | ----------------------------------- |
| file\_id         | str            | Unique identifier for the file path |
| file\_name       | str            | Display name of the file            |
| branch           | Optional\[str] | Branch for this file version        |
| 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         |

{/* AUTO-GENERATED CONTENT END */}