> ## 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.