Bitbucket
Comprehensive Bitbucket connector for managing repositories, pull requests, issues, pipelines, branches, commits, and webhooks through the Bitbucket Cloud API v2.0.
Categories: Version Control, DevOps, CI/CD, Code Collaboration
What you can ask
- List open pull requests in the
acme/apirepo that haven't had a review in 3 days. - Open a pull request from
feature/authintomainwith the commit log as the body. - Find every repo with no commits in the last 90 days for archive review.
Set up
Bitbucket needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Bitbucket. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Bitbucket developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Bitbucket login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (8)
Grant the scopes for the tools you plan to allow.
accountpipelinepipeline:writepullrequestpullrequest:writerepositoryrepository:writewebhook
Tools
Bitbucket offers 54 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (33)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_branch | Get branch details by name |
get_commit | Get commit details by hash |
get_commit_diff | Get commit diff |
get_current_user | Get authenticated user profile |
get_default_branch | Get repository default branch |
get_pipeline | Get pipeline details by UUID |
get_pipeline_step | Get pipeline step details |
get_pipeline_step_log | Get pipeline step logs |
get_pullrequest | Get pull request details by ID |
get_pullrequest_activity | Get pull request activity log |
get_pullrequest_diff | Get pull request diff |
get_repository | Get repository details by slug |
get_webhook | Get webhook details by UUID |
get_workspace | Get workspace details |
list_branches | List repository branches |
list_commit_comments | List commit comments |
list_commit_statuses | List commit build statuses |
list_commits | List repository commits with filters |
list_pipeline_steps | List pipeline steps |
list_pipeline_variables | List pipeline variables |
list_pipelines | List repository pipelines |
list_pullrequest_comments | List pull request comments |
list_pullrequest_commits | List pull request commits |
list_pullrequest_statuses | List pull request build statuses |
list_pullrequests | List pull requests with filtering options |
list_repositories | List repositories in a workspace with pagination |
list_repository_forks | List repository forks |
list_repository_watchers | List repository watchers |
list_user_emails | List user email addresses |
list_webhooks | List repository webhooks |
list_workspace_members | List workspace members |
list_workspaces | List accessible workspaces |
validate_credential | Validate Bitbucket credentials. |
Write (7)
Create or send data.
| Tool | What it does |
|---|---|
create_branch | Create a new branch |
create_pullrequest | Create a new pull request |
create_pullrequest_comment | Add a comment to a pull request |
create_repository | Create a new repository in a workspace |
create_webhook | Create a repository webhook |
fork_repository | Fork a repository |
trigger_pipeline | Trigger a new pipeline run |
Delete or overwrite (14)
Remove or replace existing data.
| Tool | What it does |
|---|---|
approve_commit | Approve a commit |
approve_pullrequest | Approve a pull request |
decline_pullrequest | Decline a pull request |
delete_branch | Delete a branch |
delete_repository | Delete repository permanently |
delete_webhook | Delete webhook permanently |
merge_pullrequest | Merge a pull request |
request_pullrequest_changes | Request changes on a pull request |
stop_pipeline | Stop a running pipeline |
unapprove_commit | Remove commit approval |
unapprove_pullrequest | Remove approval from a pull request |
update_pullrequest | Update pull request details |
update_repository | Update repository settings |
update_webhook | Update webhook configuration |