# Bitbucket

Manage Bitbucket: repositories, pull requests, commits, pipelines, issues. Exposes **34 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `bitbucket_workspaces_list` | List workspaces accessible to authenticated user - GET /workspaces. |
| `bitbucket_workspace_get` | Get workspace details - GET /workspaces/{workspace}. |
| `bitbucket_workspace_update` | Update workspace - PATCH /workspaces/{workspace}. |
| `bitbucket_repositories_list` | List repositories in a workspace - GET /repositories/{workspace}. |
| `bitbucket_repository_get` | Get repository details - GET /repositories/{workspace}/{repo_slug}. |
| `bitbucket_repository_create` | Create a new repository - POST /repositories/{workspace}. |
| `bitbucket_repository_update` | Update repository - PUT /repositories/{workspace}/{repo_slug}. |
| `bitbucket_repository_delete` | Delete a repository - DELETE /repositories/{workspace}/{repo_slug}. |
| `bitbucket_repository_fork` | Fork a repository - POST /repositories/{workspace}/{repo_slug}/forks. |
| `bitbucket_repository_clone_links` | Get repository clone links (git/ssh URLs) - GET /repositories/{workspace}/{repo_slug}. |
| `bitbucket_commits_list` | List commits in a repository - GET /repositories/{workspace}/{repo_slug}/commits. |
| `bitbucket_commit_get` | Get commit details - GET /repositories/{workspace}/{repo_slug}/commit/{hash}. |
| `bitbucket_branches_list` | List branches in a repository - GET /repositories/{workspace}/{repo_slug}/refs/branches. |
| `bitbucket_branch_get` | Get branch details - GET /repositories/{workspace}/{repo_slug}/refs/branches/{name}. |
| `bitbucket_branch_create` | Create a new branch - POST /repositories/{workspace}/{repo_slug}/refs/branches. |
| `bitbucket_branch_delete` | Delete a branch - DELETE /repositories/{workspace}/{repo_slug}/refs/branches/{name}. |
| `bitbucket_pull_requests_list` | List pull requests in a repository - GET /repositories/{workspace}/{repo_slug}/pullrequests. |
| `bitbucket_pull_request_get` | Get pull request details - GET /repositories/{workspace}/{repo_slug}/pullrequests/{id}. |
| `bitbucket_pull_request_create` | Create a pull request - POST /repositories/{workspace}/{repo_slug}/pullrequests. |
| `bitbucket_pull_request_update` | Update a pull request - PUT /repositories/{workspace}/{repo_slug}/pullrequests/{id}. |
| `bitbucket_pull_request_merge` | Merge a pull request - POST /repositories/{workspace}/{repo_slug}/pullrequests/{id}/merge. |
| `bitbucket_pull_request_decline` | Decline a pull request - POST /repositories/{workspace}/{repo_slug}/pullrequests/{id}/decline. |
| `bitbucket_pull_request_comment_create` | Create a comment on a pull request - POST /repositories/{workspace}/{repo_slug}/pullrequests/{id}/comments. |
| `bitbucket_pull_request_comments_list` | List comments on a pull request - GET /repositories/{workspace}/{repo_slug}/pullrequests/{id}/comments. |
| `bitbucket_issues_list` | List issues in a repository - GET /repositories/{workspace}/{repo_slug}/issues. |
| `bitbucket_issue_get` | Get issue details - GET /repositories/{workspace}/{repo_slug}/issues/{id}. |
| `bitbucket_issue_create` | Create an issue - POST /repositories/{workspace}/{repo_slug}/issues. |
| `bitbucket_issue_update` | Update an issue - PUT /repositories/{workspace}/{repo_slug}/issues/{id}. |
| `bitbucket_issue_delete` | Delete an issue - DELETE /repositories/{workspace}/{repo_slug}/issues/{id}. |
| `bitbucket_pipelines_list` | List pipelines in a repository - GET /repositories/{workspace}/{repo_slug}/pipelines. |
| `bitbucket_pipeline_get` | Get pipeline details - GET /repositories/{workspace}/{repo_slug}/pipelines/{uuid}. |
| `bitbucket_pipeline_trigger` | Trigger a pipeline - POST /repositories/{workspace}/{repo_slug}/pipelines. |
| `bitbucket_deployments_list` | List deployments in a repository - GET /repositories/{workspace}/{repo_slug}/deployments. |
| `bitbucket_deployment_get` | Get deployment details - GET /repositories/{workspace}/{repo_slug}/deployments/{uuid}. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Bitbucket to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Bitbucket API documentation](https://developer.atlassian.com/cloud/bitbucket/rest/)