> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

> Connect Bitbucket to your Atako agents — 22 read and 12 write actions.

Let your agents work with your Bitbucket Cloud workspaces — browse repositories, branches and commits, and manage pull requests on your behalf.

## Connection

* **Authentication**: API key (username:app\_password).

<Note>
  Bitbucket → click your avatar → Personal settings → App passwords → Create app password. Grant at least "Account: Read", "Workspace membership: Read", "Projects: Read/Write", "Repositories: Read/Write/Admin", "Pull requests: Read/Write", "Issues: Read/Write", "Webhooks: Read and write" and "Pipelines: Read". Find your username under Personal settings → Account settings, then enter the credential as username:app\_password (colon-separated).

  See [Bitbucket's documentation](https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/).
</Note>

## Read actions (22)

| Action | Description |
| - | - |
| `get_commit` | Fetch a single commit by hash. |
| `get_current_user` | Fetch the profile of the authenticated user. |
| `get_issue` | Fetch a single issue by id. |
| `get_project` | Fetch a single project by its key. |
| `get_pull_request` | Fetch a single pull request by id. |
| `get_repository` | Fetch a single repository by workspace and slug. |
| `get_workspace` | Fetch a single workspace by its slug. |
| `list_branches` | List branches of a repository. |
| `list_commits` | List commits of a repository, optionally scoped to a branch or revision. |
| `list_deployment_environments` | List deployment environments of a repository. |
| `list_issues` | List issues in a repository issue tracker. |
| `list_pipelines` | List pipeline runs of a repository. |
| `list_pr_activity` | List the activity log (approvals, updates, comments) of a pull request. |
| `list_pr_comments` | List comments on a pull request. |
| `list_pr_commits` | List the commits included in a pull request. |
| `list_projects` | List projects in a workspace. |
| `list_pull_requests` | List pull requests of a repository, optionally filtered by state. |
| `list_repositories` | List repositories in a workspace. |
| `list_tags` | List tags of a repository. |
| `list_watchers` | List users watching a repository. |
| `list_webhooks` | List webhooks configured on a repository. |
| `list_workspaces` | List workspaces the authenticated user is a member of. |

## Write actions (12)

| Action | Description |
| - | - |
| `create_branch` | Create a branch pointing at a target commit hash. |
| `create_issue` | Open an issue in a repository issue tracker. |
| `create_pr_comment` | Add a comment to a pull request. |
| `create_project` | Create a project in a workspace. |
| `create_pull_request` | Open a pull request from a source branch to a destination branch. |
| `create_repository` | Create a repository in a workspace. |
| `create_webhook` | Create a webhook on a repository for the given events. |
| `decline_pull_request` | Decline (reject) an open pull request. |
| `delete_branch` | Delete a branch by name. |
| `delete_repository` | Permanently delete a repository. |
| `delete_webhook` | Delete a repository webhook by its uid. |
| `merge_pull_request` | Merge an open pull request. |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: July 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.