Bitbucket Toolkit
The Bitbucket Toolkit is a workflow node. Its tools include List Repositories, Get Repository, Search Repositories, and Get File Content, plus 8 more listed below. Connect a Bitbucket account before you use any of these tools. Type @ in a field when the value should come from an earlier step.
Authentication
Every Bitbucket tool needs a connected account before it can run. On the node, open Bitbucket Account.
- Choose Use my Bitbucket account or Use team account.
- If no personal account is connected, click Connect Bitbucket Account and finish sign-in.
- For a team account, choose Use team account and pick one from Team account. The list shows accounts already connected for the project.
Tools
List Repositories
Lists repositories.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | No | Workspace slug to filter repositories (optional, uses all accessible workspaces if not provided). Default is null. Type @ to select a variable. |
| Role | No | Filter by role: 'owner', 'admin', 'contributor', 'member'. Default is null. Type @ to select a variable. |
| Sort | No | Sort by: 'name', 'created_on', 'updated_on' (prefix with - for descending). Default is -updated_on. Type @ to select a variable. |
| Page | No | Page number for pagination. Default is 1. |
| Pagelen | No | Number of repositories per page (1-100). Default is 30. |
Get Repository
Retrieves repository.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
Search Repositories
Searches repositories.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Query | Yes | Search query string. Type @ to select a variable. |
| Sort | No | Sort by: 'name', 'created_on', 'updated_on' (prefix with - for descending). Default is -updated_on. Type @ to select a variable. |
| Page | No | Page number for pagination. Default is 1. |
| Pagelen | No | Number of repositories per page (1-100). Default is 30. |
Get File Content
Retrieves file content.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| Path | Yes | File path in the repository. Type @ to select a variable. |
| Ref | No | Branch name, tag, or commit hash (defaults to main branch). Default is null. Type @ to select a variable. |
List Branches
Lists branches.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| Sort | No | Sort by: 'name', 'target.date'. Default is -target.date. Type @ to select a variable. |
| Page | No | Page number for pagination. Default is 1. |
| Pagelen | No | Number of branches per page (1-100). Default is 30. |
List Pull Requests
Lists pull requests.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| State | No | PR state: 'OPEN', 'MERGED', 'DECLINED', 'SUPERSEDED'. Default is OPEN. Type @ to select a variable. |
| Sort | No | Sort by: 'created_on', 'updated_on'. Default is -updated_on. Type @ to select a variable. |
| Page | No | Page number for pagination. Default is 1. |
| Pagelen | No | Number of PRs per page (1-100). Default is 30. |
Get Pull Request
Retrieves pull request.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| Pull Request ID | Yes | Pull request ID. |
Create Pull Request
Creates pull request.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| Title | Yes | Pull request title. Type @ to select a variable. |
| Source Branch | Yes | Source branch name. Type @ to select a variable. |
| Destination Branch | Yes | Destination branch name. Type @ to select a variable. |
| Description | No | Pull request description. Default is null. Type @ to select a variable. |
| Close Source Branch | No | Close source branch after merge. Default is false. |
List Issues
Lists issues.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| State | No | Issue state: 'new', 'open', 'resolved', 'on hold', 'invalid', 'duplicate', 'wontfix', 'closed'. Default is null. Type @ to select a variable. |
| Sort | No | Sort by: 'created_on', 'updated_on', 'priority'. Default is -updated_on. Type @ to select a variable. |
| Page | No | Page number for pagination. Default is 1. |
| Pagelen | No | Number of issues per page (1-100). Default is 30. |
Create Issue
Creates issue.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| Title | Yes | Issue title. Type @ to select a variable. |
| Content | No | Issue description/content. Default is null. Type @ to select a variable. |
| Kind | No | Issue kind: 'bug', 'enhancement', 'proposal', 'task'. Default is bug. Type @ to select a variable. |
| Priority | No | Issue priority: 'trivial', 'minor', 'major', 'critical', 'blocker'. Default is major. Type @ to select a variable. |
Get Commit History
Retrieves commit history.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
| Workspace | Yes | Workspace slug (username or team name). Type @ to select a variable. |
| Repo Slug | Yes | Repository slug. Type @ to select a variable. |
| Branch | No | Branch name (defaults to main branch). Default is null. Type @ to select a variable. |
| Page | No | Page number for pagination. Default is 1. |
| Pagelen | No | Number of commits per page (1-100). Default is 30. |
Get Workspaces
Retrieves workspaces.
| Field | Required | Description |
|---|---|---|
| Bitbucket Account | Yes | Select your personal or team Bitbucket account. |
Related
Agents can use this integration from chat. See Bitbucket.
See all integrations on the toolkits overview.