Bitbucket
OAuth 2.0 developmentversion_controlcollaborationci_cdBitbucket
What you can do
Section titled “What you can do”Connect this agent connector to let your agent:
- Get commit comment, workspace, merge base — Returns a specific comment on a commit
- Search workspace — Searches for code across all repositories in a workspace
- Delete workspace pipeline variable, deploy key, repository permission user — Deletes a workspace pipeline variable
- Create tag, environment, commit build status — Creates a new tag in a Bitbucket repository pointing to a specific commit
- Update pull request task, deployment variable, commit build status — Updates a task on a pull request (e.g
- Unwatch issue — Stops watching an issue
Authentication
Section titled “Authentication”This connector uses OAuth 2.0. Scalekit acts as the OAuth client: it redirects your user to Bitbucket, obtains an access token, and automatically refreshes it before it expires. Your agent code never handles tokens directly — you only pass a connectionName and a user identifier.
You supply your Bitbucket Connected App credentials (Client ID + Secret) once per environment in the Scalekit dashboard.
Set up the connector
Register your Bitbucket OAuth consumer credentials with Scalekit so it can manage the OAuth 2.0 authentication flow and token lifecycle on your behalf. You’ll need a Key (Client ID) and Secret (Client Secret) from your Bitbucket workspace settings.
-
Open OAuth consumers in your Bitbucket workspace
-
Go to Bitbucket and open your workspace by clicking your avatar in the top-right corner and selecting the workspace you want to use.
-
In the left sidebar, click Settings → OAuth consumers.

-
Click Add consumer to create a new OAuth application.
-
-
Create the OAuth consumer
-
Fill in the consumer details:
- Name — enter a descriptive name (e.g.,
Scalekit-Agent) - Description — optional description
- URL — your application’s homepage URL
- Name — enter a descriptive name (e.g.,
-
Leave the Callback URL field empty for now — you’ll fill it in after getting the redirect URI from Scalekit.

-
Under Permissions, select the scopes your agent needs. Recommended minimum:
Permission Scope Required for Account Read User profile access Repositories Read Read code and metadata Repositories Write Create branches, push commits Pull requests Read Read PR data Pull requests Write Create, approve, and merge PRs Pipelines Read View pipeline runs Pipelines Write Trigger pipelines -
Click Save to create the consumer.
-
-
Get the redirect URI from Scalekit
-
In Scalekit dashboard, go to Agent Auth → Create Connection. Search for Bitbucket and click Create.

-
Copy the Redirect URI shown in the connection configuration panel. It looks like
https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.
-
-
Add the callback URL in Bitbucket
-
Back in Bitbucket, open your OAuth consumer and click Edit.
-
Paste the Scalekit Redirect URI into the Callback URL field.
-
Click Save to apply the change.

-
-
Copy your OAuth credentials
-
In Bitbucket, go back to Workspace settings → OAuth consumers and click on your consumer name to expand it.
-
The Key and Secret will be shown. Click Reveal next to the secret to display it.

-
Copy both values. The secret is not stored by Bitbucket after you leave this page — save it securely.
-
-
Add credentials in Scalekit
-
In Scalekit dashboard, go to Agent Auth → Connections and open the Bitbucket connection you created.
-
Enter your credentials:
- Client Key — the Key from your Bitbucket OAuth consumer
- Client Secret — the Secret from your Bitbucket OAuth consumer
- Scopes — select the scopes that match the permissions you granted in step 2
-
Click Save.
-
Code examples
Connect a user’s Bitbucket account and make API calls on their behalf — Scalekit handles OAuth 2.0, token storage, and refresh automatically.
You can interact with Bitbucket in two ways — via direct proxy API calls or via Scalekit optimized tool calls. Scroll down to see the list of available Scalekit tools.
Proxy API calls
import { ScalekitClient } from '@scalekit-sdk/node';import 'dotenv/config';
const connectionName = 'bitbucket'; // get your connection name from connection configurationsconst identifier = 'user_123'; // your unique user identifier
// Get your credentials from app.scalekit.com → Developers → Settings → API Credentialsconst scalekit = new ScalekitClient( process.env.SCALEKIT_ENV_URL, process.env.SCALEKIT_CLIENT_ID, process.env.SCALEKIT_CLIENT_SECRET);const actions = scalekit.actions;
// Authenticate the user — send this link to your userconst { link } = await actions.getAuthorizationLink({ connectionName, identifier,});console.log('Authorize Bitbucket:', link);process.stdout.write('Press Enter after authorizing...');await new Promise(r => process.stdin.once('data', r));
// Fetch the authenticated user's Bitbucket profile via Scalekit proxyconst user = await actions.request({ connectionName, identifier, path: '/2.0/user', method: 'GET',});console.log(user);import scalekit.client, osfrom dotenv import load_dotenvload_dotenv()
connection_name = "bitbucket" # get your connection name from connection configurationsidentifier = "user_123" # your unique user identifier
# Get your credentials from app.scalekit.com → Developers → Settings → API Credentialsscalekit_client = scalekit.client.ScalekitClient( client_id=os.getenv("SCALEKIT_CLIENT_ID"), client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"), env_url=os.getenv("SCALEKIT_ENV_URL"),)actions = scalekit_client.actions
# Authenticate the user — present this link to your userlink_response = actions.get_authorization_link( connection_name=connection_name, identifier=identifier)print("Authorize Bitbucket:", link_response.link)input("Press Enter after authorizing...")
# Fetch the authenticated user's Bitbucket profile via Scalekit proxyuser = actions.request( connection_name=connection_name, identifier=identifier, path="/2.0/user", method="GET")print(user)Scalekit tools
Tool list
Section titled “Tool list” bitbucket_branch_create Creates a new branch in a Bitbucket repository from a specified commit hash or branch. 4 params
Creates a new branch in a Bitbucket repository from a specified commit hash or branch.
name string required Name for the new branch. repo_slug string required The repository slug or UUID. target_hash string required The commit hash to create the branch from. workspace string required The workspace slug or UUID. bitbucket_branch_delete Deletes a branch from a Bitbucket repository. 3 params
Deletes a branch from a Bitbucket repository.
name string required The branch name to delete. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_branch_get Returns details of a specific branch in a Bitbucket repository. 3 params
Returns details of a specific branch in a Bitbucket repository.
name string required The branch name. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_branch_restriction_create Creates a branch permission rule for a repository. 7 params
Creates a branch permission rule for a repository.
kind string required Restriction type: require_tasks_to_be_completed, require_approvals_to_merge, require_default_reviewer_approvals_to_merge, require_no_changes_requested, require_commits_behind, require_passing_builds_to_merge, reset_pullrequest_approvals_on_change, push, restrict_merges, force, delete, enforce_merge_checks. pattern string required Branch name or glob pattern to restrict, e.g. 'main' or 'release/*'. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. groups string optional List of group slugs to exempt from the restriction. users string optional List of user account IDs to exempt from the restriction. value string optional Numeric value for count-based restrictions (e.g. required approvals). bitbucket_branch_restriction_delete Deletes a branch permission rule. 3 params
Deletes a branch permission rule.
id string required The numeric ID of the branch restriction. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_branch_restriction_get Returns a specific branch permission rule by ID. 3 params
Returns a specific branch permission rule by ID.
id string required The numeric ID of the branch restriction. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_branch_restriction_update Updates a branch permission rule. 6 params
Updates a branch permission rule.
id string required The numeric ID of the branch restriction. kind string required Restriction type (see Create Branch Restriction for valid values). pattern string required Branch name or glob pattern. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. value string optional Numeric value for count-based restrictions. bitbucket_branch_restrictions_list Lists branch permission rules for a repository. 2 params
Lists branch permission rules for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_branches_list Returns all branches in a Bitbucket repository. 4 params
Returns all branches in a Bitbucket repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. q string optional Query to filter branches, e.g. name~"feature". sort string optional Sort field, e.g. -target.date for newest first. bitbucket_branching_model_get Returns the effective branching model for a repository (e.g. Gitflow config). 2 params
Returns the effective branching model for a repository (e.g. Gitflow config).
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_branching_model_settings_get Returns the branching model configuration settings for a repository. 2 params
Returns the branching model configuration settings for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_branching_model_settings_update Updates the branching model configuration settings for a repository. 4 params
Updates the branching model configuration settings for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. development_branch string optional Name of the development branch. production_branch string optional Name of the production branch. bitbucket_commit_approve Approves a specific commit in a Bitbucket repository. 3 params
Approves a specific commit in a Bitbucket repository.
commit string required The commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_build_status_create Creates or updates a build status for a specific commit (used to report CI/CD results). 8 params
Creates or updates a build status for a specific commit (used to report CI/CD results).
commit string required The commit hash. key string required Unique identifier for the build (e.g. CI pipeline name). repo_slug string required The repository slug or UUID. state string required Build state: SUCCESSFUL, FAILED, INPROGRESS, STOPPED. url string required URL linking to the build result. workspace string required The workspace slug or UUID. description string optional Description of the build result. name string optional Display name for the build. bitbucket_commit_build_status_get Returns the build status for a specific commit and build key. 4 params
Returns the build status for a specific commit and build key.
commit string required The commit hash. key string required Unique identifier for the build. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_build_status_update Updates an existing build status for a specific commit and key. 8 params
Updates an existing build status for a specific commit and key.
commit string required The commit hash. key string required Unique identifier for the build. repo_slug string required The repository slug or UUID. state string required Build state: SUCCESSFUL, FAILED, INPROGRESS, STOPPED. url string required URL linking to the build result. workspace string required The workspace slug or UUID. description string optional Description of the build result. name string optional Display name for the build. bitbucket_commit_comment_create Creates a new comment on a specific commit in a Bitbucket repository. 4 params
Creates a new comment on a specific commit in a Bitbucket repository.
commit string required The commit hash. content string required The comment text (Markdown supported). repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_comment_delete Deletes a specific comment on a commit. 4 params
Deletes a specific comment on a commit.
comment_id string required The numeric ID of the comment. commit string required The commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_comment_get Returns a specific comment on a commit. 4 params
Returns a specific comment on a commit.
comment_id string required The numeric ID of the comment. commit string required The commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_comment_update Updates an existing comment on a commit. 5 params
Updates an existing comment on a commit.
comment_id string required The numeric ID of the comment. commit string required The commit hash. content string required Updated comment text (Markdown supported). repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_comments_list Lists all comments on a specific commit in a Bitbucket repository. 3 params
Lists all comments on a specific commit in a Bitbucket repository.
commit string required The commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_get Returns details of a specific commit including author, message, date, and diff stats. 3 params
Returns details of a specific commit including author, message, date, and diff stats.
commit string required The commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_statuses_list Lists all statuses (build results) for a specific commit. 3 params
Lists all statuses (build results) for a specific commit.
commit string required The commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commit_unapprove Removes an approval from a specific commit. 3 params
Removes an approval from a specific commit.
commit string required The commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_commits_list Returns a list of commits for a repository, optionally filtered by branch. 3 params
Returns a list of commits for a repository, optionally filtered by branch.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. branch string optional Branch or tag name to list commits for. bitbucket_component_get Returns a specific component by ID from the issue tracker. 3 params
Returns a specific component by ID from the issue tracker.
component_id string required The numeric ID of the component. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_components_list Lists all components defined for a repository's issue tracker. 2 params
Lists all components defined for a repository's issue tracker.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_default_reviewer_add Adds a user as a default reviewer for a repository. 3 params
Adds a user as a default reviewer for a repository.
repo_slug string required The repository slug or UUID. username string required The user's account ID or UUID. workspace string required The workspace slug or UUID. bitbucket_default_reviewer_get Checks if a user is a default reviewer for a repository. 3 params
Checks if a user is a default reviewer for a repository.
repo_slug string required The repository slug or UUID. username string required The user's account ID or UUID. workspace string required The workspace slug or UUID. bitbucket_default_reviewer_remove Removes a user from the default reviewers for a repository. 3 params
Removes a user from the default reviewers for a repository.
repo_slug string required The repository slug or UUID. username string required The user's account ID or UUID. workspace string required The workspace slug or UUID. bitbucket_default_reviewers_list Lists all default reviewers for a repository. 2 params
Lists all default reviewers for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_deploy_key_create Adds a new deploy key (SSH public key) to a Bitbucket repository for read-only or read-write access. 4 params
Adds a new deploy key (SSH public key) to a Bitbucket repository for read-only or read-write access.
key string required The SSH public key string. label string required A human-readable label for the deploy key. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_deploy_key_delete Removes a deploy key from a Bitbucket repository. 3 params
Removes a deploy key from a Bitbucket repository.
key_id integer required The integer ID of the deploy key to delete. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_deploy_keys_list Returns a list of deploy keys (SSH keys) configured on a Bitbucket repository. 2 params
Returns a list of deploy keys (SSH keys) configured on a Bitbucket repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_deployment_get Returns a specific deployment by UUID. 3 params
Returns a specific deployment by UUID.
deployment_uuid string required The UUID of the deployment. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_deployment_variable_create Creates a new variable for a deployment environment. 6 params
Creates a new variable for a deployment environment.
environment_uuid string required The UUID of the environment. key string required Variable name. repo_slug string required The repository slug or UUID. value string required Variable value. workspace string required The workspace slug or UUID. secured string optional Whether the variable is secret (masked in logs). bitbucket_deployment_variable_delete Deletes a variable from a deployment environment. 4 params
Deletes a variable from a deployment environment.
environment_uuid string required The UUID of the environment. repo_slug string required The repository slug or UUID. variable_uuid string required The UUID of the variable. workspace string required The workspace slug or UUID. bitbucket_deployment_variable_update Updates an existing variable for a deployment environment. 7 params
Updates an existing variable for a deployment environment.
environment_uuid string required The UUID of the environment. key string required Variable name. repo_slug string required The repository slug or UUID. value string required Variable value. variable_uuid string required The UUID of the variable. workspace string required The workspace slug or UUID. secured string optional Whether the variable is secret. bitbucket_deployment_variables_list Lists all variables for a deployment environment. 3 params
Lists all variables for a deployment environment.
environment_uuid string required The UUID of the environment. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_deployments_list Lists all deployments for a repository. 2 params
Lists all deployments for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_diff_get Returns a JSON summary of file changes (diffstat) for a given commit spec (e.g. commit hash, branch..branch). Shows which files were added, modified, or deleted with line counts. 4 params
Returns a JSON summary of file changes (diffstat) for a given commit spec (e.g. commit hash, branch..branch). Shows which files were added, modified, or deleted with line counts.
repo_slug string required The repository slug or UUID. spec string required Diff spec in the form of 'hash1..hash2' or 'branch1..branch2'. workspace string required The workspace slug or UUID. path string optional Limit diff to a specific file path. bitbucket_diffstat_get Returns the diff stats between two commits or a branch/commit spec in a repository. 3 params
Returns the diff stats between two commits or a branch/commit spec in a repository.
repo_slug string required The repository slug or UUID. spec string required Revision spec e.g. 'main..feature' or commit SHA. workspace string required The workspace slug or UUID. bitbucket_download_delete Deletes a specific download artifact from a repository. 3 params
Deletes a specific download artifact from a repository.
filename string required The filename of the download artifact. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_downloads_list Lists all download artifacts for a repository. 2 params
Lists all download artifacts for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_environment_create Creates a new deployment environment for a repository. 4 params
Creates a new deployment environment for a repository.
environment_type string required Type: Test, Staging, or Production. name string required Name of the environment. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_environment_delete Deletes a deployment environment by UUID. 3 params
Deletes a deployment environment by UUID.
environment_uuid string required The UUID of the environment. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_environment_get Returns a specific deployment environment by UUID. 3 params
Returns a specific deployment environment by UUID.
environment_uuid string required The UUID of the environment. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_environments_list Lists all deployment environments for a repository (e.g. Test, Staging, Production). 2 params
Lists all deployment environments for a repository (e.g. Test, Staging, Production).
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_file_history_list Lists the commits that modified a specific file path. 4 params
Lists the commits that modified a specific file path.
commit string required The commit hash or branch name. path string required Path to the file in the repository. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_comment_create Posts a new comment on a Bitbucket issue. 4 params
Posts a new comment on a Bitbucket issue.
content string required The comment text (Markdown supported). issue_id integer required The issue ID to comment on. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_comment_delete Deletes a specific comment on an issue. 4 params
Deletes a specific comment on an issue.
comment_id string required The numeric ID of the comment. issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_comment_update Updates an existing comment on an issue. 5 params
Updates an existing comment on an issue.
comment_id string required The numeric ID of the comment. content string required Updated comment text (Markdown). issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_comments_list Returns all comments on a Bitbucket issue. 3 params
Returns all comments on a Bitbucket issue.
issue_id integer required The issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_create Creates a new issue in a Bitbucket repository's issue tracker. 7 params
Creates a new issue in a Bitbucket repository's issue tracker.
repo_slug string required The repository slug or UUID. title string required Title of the issue. workspace string required The workspace slug or UUID. assignee_account_id string optional Account ID of the assignee. content string optional Description/body of the issue (Markdown supported). kind string optional Issue kind: bug, enhancement, proposal, or task. priority string optional Priority: trivial, minor, major, critical, or blocker. bitbucket_issue_delete Deletes an issue from a Bitbucket repository's issue tracker. 3 params
Deletes an issue from a Bitbucket repository's issue tracker.
issue_id integer required The issue ID to delete. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_get Returns details of a specific issue in a Bitbucket repository. 3 params
Returns details of a specific issue in a Bitbucket repository.
issue_id integer required The issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_unvote Removes a vote from an issue. 3 params
Removes a vote from an issue.
issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_unwatch Stops watching an issue. 3 params
Stops watching an issue.
issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_update Updates an existing issue in a Bitbucket repository. 8 params
Updates an existing issue in a Bitbucket repository.
issue_id integer required The issue ID to update. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. content string optional New content/body for the issue. kind string optional Issue kind: bug, enhancement, proposal, or task. priority string optional Priority: trivial, minor, major, critical, or blocker. status string optional Issue status: new, open, resolved, on hold, invalid, duplicate, or wontfix. title string optional New title for the issue. bitbucket_issue_vote Casts a vote for an issue. 3 params
Casts a vote for an issue.
issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_vote_get Checks if the authenticated user has voted for an issue. 3 params
Checks if the authenticated user has voted for an issue.
issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_watch Starts watching an issue to receive notifications. 3 params
Starts watching an issue to receive notifications.
issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issue_watch_get Checks if the authenticated user is watching an issue. 3 params
Checks if the authenticated user is watching an issue.
issue_id string required The numeric issue ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_issues_list Returns all issues in a Bitbucket repository's issue tracker. 4 params
Returns all issues in a Bitbucket repository's issue tracker.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. q string optional Filter query, e.g. status="open" AND priority="major". sort string optional Sort field, e.g. -updated_on. bitbucket_merge_base_get Returns the common ancestor (merge base) between two commits. 3 params
Returns the common ancestor (merge base) between two commits.
repo_slug string required The repository slug or UUID. revspec string required Two commits separated by '..', e.g. 'abc123..def456'. workspace string required The workspace slug or UUID. bitbucket_milestone_get Returns a specific milestone by ID from the issue tracker. 3 params
Returns a specific milestone by ID from the issue tracker.
milestone_id string required The numeric ID of the milestone. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_milestones_list Lists all milestones defined for a repository's issue tracker. 2 params
Lists all milestones defined for a repository's issue tracker.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pipeline_get Returns details of a specific Bitbucket pipeline run by its UUID. 3 params
Returns details of a specific Bitbucket pipeline run by its UUID.
pipeline_uuid string required The pipeline UUID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pipeline_schedule_create Creates a new pipeline schedule for a repository. 5 params
Creates a new pipeline schedule for a repository.
branch string required Branch to run the pipeline on. cron_expression string required Cron schedule expression (e.g. '0 0 * * *' for daily midnight). repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. enabled string optional Whether the schedule is active. bitbucket_pipeline_schedule_delete Deletes a pipeline schedule. 3 params
Deletes a pipeline schedule.
repo_slug string required The repository slug or UUID. schedule_uuid string required The UUID of the schedule. workspace string required The workspace slug or UUID. bitbucket_pipeline_schedule_get Returns a specific pipeline schedule by UUID. 3 params
Returns a specific pipeline schedule by UUID.
repo_slug string required The repository slug or UUID. schedule_uuid string required The UUID of the schedule. workspace string required The workspace slug or UUID. bitbucket_pipeline_schedule_update Updates a pipeline schedule. 5 params
Updates a pipeline schedule.
repo_slug string required The repository slug or UUID. schedule_uuid string required The UUID of the schedule. workspace string required The workspace slug or UUID. cron_expression string optional Updated cron expression. enabled string optional Whether the schedule is active. bitbucket_pipeline_schedules_list Lists all pipeline schedules for a repository. 2 params
Lists all pipeline schedules for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pipeline_step_log_get Retrieves the log output for a specific step of a Bitbucket pipeline run. 4 params
Retrieves the log output for a specific step of a Bitbucket pipeline run.
pipeline_uuid string required The UUID of the pipeline. repo_slug string required The repository slug or UUID. step_uuid string required The UUID of the pipeline step. workspace string required The workspace slug or UUID. bitbucket_pipeline_steps_list Returns a list of steps for a specific Bitbucket pipeline run. 3 params
Returns a list of steps for a specific Bitbucket pipeline run.
pipeline_uuid string required The UUID of the pipeline. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pipeline_stop Stops a running Bitbucket pipeline by sending a stop request to the specified pipeline UUID. 3 params
Stops a running Bitbucket pipeline by sending a stop request to the specified pipeline UUID.
pipeline_uuid string required The UUID of the pipeline to stop. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pipeline_trigger Triggers a new Bitbucket pipeline run for a specific branch, tag, or commit. 6 params
Triggers a new Bitbucket pipeline run for a specific branch, tag, or commit.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. branch string optional Branch name to run the pipeline on. commit_hash string optional Specific commit hash to run the pipeline on. pipeline_name string optional Custom pipeline name defined in bitbucket-pipelines.yml. variables string optional JSON array of pipeline variables, e.g. [{"key":"ENV","value":"prod"}]. bitbucket_pipeline_variable_create Creates a new pipeline variable for a Bitbucket repository. 5 params
Creates a new pipeline variable for a Bitbucket repository.
key string required The variable name/key. repo_slug string required The repository slug or UUID. value string required The variable value. workspace string required The workspace slug or UUID. secured boolean optional If true, the variable value is masked in logs. bitbucket_pipeline_variable_delete Deletes a pipeline variable from a Bitbucket repository. 3 params
Deletes a pipeline variable from a Bitbucket repository.
repo_slug string required The repository slug or UUID. variable_uuid string required The UUID of the pipeline variable to delete. workspace string required The workspace slug or UUID. bitbucket_pipeline_variable_update Updates an existing pipeline variable for a Bitbucket repository. 6 params
Updates an existing pipeline variable for a Bitbucket repository.
key string required The new variable name/key. repo_slug string required The repository slug or UUID. value string required The new variable value. variable_uuid string required The UUID of the pipeline variable to update. workspace string required The workspace slug or UUID. secured boolean optional If true, the variable value is masked in logs. bitbucket_pipeline_variables_list Returns a list of pipeline variables defined for the repository. 2 params
Returns a list of pipeline variables defined for the repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pipelines_list Returns pipeline runs for a Bitbucket repository, optionally filtered by status or branch. 3 params
Returns pipeline runs for a Bitbucket repository, optionally filtered by status or branch.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. sort string optional Sort field, e.g. -created_on for newest first. bitbucket_pull_request_activity_list Lists all activity (comments, approvals, updates) for a specific pull request. 3 params
Lists all activity (comments, approvals, updates) for a specific pull request.
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_approve Approves a pull request on behalf of the authenticated user. 3 params
Approves a pull request on behalf of the authenticated user.
pull_request_id integer required The pull request ID to approve. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_comment_create Posts a new comment on a pull request. 4 params
Posts a new comment on a pull request.
content string required The comment text (Markdown supported). pull_request_id integer required The pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_comment_delete Deletes a comment from a pull request. 4 params
Deletes a comment from a pull request.
comment_id integer required The comment ID to delete. pull_request_id integer required The pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_comments_list Returns all comments on a pull request. 3 params
Returns all comments on a pull request.
pull_request_id integer required The pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_commits_list Returns all commits included in a pull request. 3 params
Returns all commits included in a pull request.
pull_request_id integer required The pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_create Creates a new pull request in a Bitbucket repository. 8 params
Creates a new pull request in a Bitbucket repository.
repo_slug string required The repository slug or UUID. source_branch string required Source branch name. title string required Title of the pull request. workspace string required The workspace slug or UUID. close_source_branch boolean optional Whether to close the source branch after merge. description string optional Description of the pull request. destination_branch string optional Destination branch to merge into. reviewers string optional JSON array of reviewer account UUIDs, e.g. [{"uuid":"{account-uuid}"}]. bitbucket_pull_request_decline Declines (rejects) an open pull request in a Bitbucket repository. 3 params
Declines (rejects) an open pull request in a Bitbucket repository.
pull_request_id integer required The pull request ID to decline. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_diffstat_get Returns a JSON diffstat for a pull request given the source and destination commit hashes. Get these from bitbucket_pull_request_get (source.commit.hash and destination.commit.hash). 5 params
Returns a JSON diffstat for a pull request given the source and destination commit hashes. Get these from bitbucket_pull_request_get (source.commit.hash and destination.commit.hash).
dest_commit string required Destination commit hash from the pull request (destination.commit.hash). repo_slug string required The repository slug or UUID. source_commit string required Source commit hash from the pull request (source.commit.hash). workspace string required The workspace slug or UUID. pull_request_id string optional The numeric pull request ID. bitbucket_pull_request_get Returns details of a specific pull request including title, description, source/destination branches, state, and reviewers. 3 params
Returns details of a specific pull request including title, description, source/destination branches, state, and reviewers.
pull_request_id integer required The pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_merge Merges a pull request in a Bitbucket repository. 6 params
Merges a pull request in a Bitbucket repository.
pull_request_id integer required The pull request ID to merge. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. close_source_branch boolean optional Whether to close the source branch after merge. merge_strategy string optional Merge strategy: merge_commit, squash, or fast_forward. message string optional Custom commit message for the merge commit. bitbucket_pull_request_remove_request_changes Removes a change request from a pull request. 3 params
Removes a change request from a pull request.
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_request_changes Requests changes on a pull request, blocking it from merging until changes are addressed. 3 params
Requests changes on a pull request, blocking it from merging until changes are addressed.
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_statuses_list Lists all commit statuses for the commits in a pull request. 3 params
Lists all commit statuses for the commits in a pull request.
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_task_create Creates a new task on a pull request. 5 params
Creates a new task on a pull request.
content string required The task description. pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. pending string optional Whether the task is pending (true) or resolved (false). bitbucket_pull_request_task_delete Deletes a task from a pull request. 4 params
Deletes a task from a pull request.
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. task_id string required The numeric task ID. workspace string required The workspace slug or UUID. bitbucket_pull_request_task_get Returns a specific task on a pull request. 4 params
Returns a specific task on a pull request.
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. task_id string required The numeric task ID. workspace string required The workspace slug or UUID. bitbucket_pull_request_task_update Updates a task on a pull request (e.g. resolve/reopen or change content). 6 params
Updates a task on a pull request (e.g. resolve/reopen or change content).
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. task_id string required The numeric task ID. workspace string required The workspace slug or UUID. content string optional Updated task description. pending string optional Set to false to resolve the task, true to reopen. bitbucket_pull_request_tasks_list Lists all tasks on a pull request. 3 params
Lists all tasks on a pull request.
pull_request_id string required The numeric pull request ID. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_unapprove Removes the authenticated user's approval from a pull request. 3 params
Removes the authenticated user's approval from a pull request.
pull_request_id integer required The pull request ID to unapprove. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_request_update Updates a pull request's title, description, reviewers, or destination branch. 6 params
Updates a pull request's title, description, reviewers, or destination branch.
pull_request_id integer required The pull request ID to update. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. description string optional New description for the pull request. destination_branch string optional New destination branch. title string optional New title for the pull request. bitbucket_pull_requests_activity_list Lists overall activity for all pull requests in a repository. 2 params
Lists overall activity for all pull requests in a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_pull_requests_list Returns pull requests for a Bitbucket repository, filterable by state. 5 params
Returns pull requests for a Bitbucket repository, filterable by state.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. q string optional Query to filter pull requests. sort string optional Sort field for pull requests. state string optional Filter by state: OPEN, MERGED, DECLINED, SUPERSEDED. bitbucket_refs_list Lists all branches and tags (refs) for a repository. 2 params
Lists all branches and tags (refs) for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repositories_list Returns all repositories in a Bitbucket workspace. 3 params
Returns all repositories in a Bitbucket workspace.
workspace string required The workspace slug or UUID. q string optional Query to filter repositories, e.g. name~"my-repo". sort string optional Sort field, e.g. -updated_on for newest first. bitbucket_repository_create Creates a new Bitbucket repository in the specified workspace. 8 params
Creates a new Bitbucket repository in the specified workspace.
repo_slug string required The slug for the new repository. workspace string required The workspace slug or UUID. description string optional A description for the repository. has_issues boolean optional Enable the issue tracker for this repository. has_wiki boolean optional Enable the wiki for this repository. is_private boolean optional Whether the repository is private. Default is true. project_key string optional Key of the project to associate the repository with. scm string optional Source control type: git or hg. Default is git. bitbucket_repository_delete Permanently deletes a Bitbucket repository and all its data. 2 params
Permanently deletes a Bitbucket repository and all its data.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_fork Forks a Bitbucket repository into the authenticated user's workspace or a specified workspace. 5 params
Forks a Bitbucket repository into the authenticated user's workspace or a specified workspace.
repo_slug string required The repository slug to fork. workspace string required The workspace slug of the source repository. is_private boolean optional Whether the fork should be private. name string optional Name for the forked repository. Defaults to the source name. workspace_destination string optional Workspace to fork into. Defaults to the authenticated user's workspace. bitbucket_repository_get Returns details of a specific Bitbucket repository including description, language, size, and clone URLs. 2 params
Returns details of a specific Bitbucket repository including description, language, size, and clone URLs.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permission_group_delete Removes a group's explicit permission from a repository. 3 params
Removes a group's explicit permission from a repository.
group_slug string required The group slug. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permission_group_get Returns the explicit repository permission for a specific group. 3 params
Returns the explicit repository permission for a specific group.
group_slug string required The group slug. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permission_group_update Sets the explicit permission for a group on a repository. 4 params
Sets the explicit permission for a group on a repository.
group_slug string required The group slug. permission string required Permission level: read, write, or admin. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permission_user_delete Removes a user's explicit permission from a repository. 3 params
Removes a user's explicit permission from a repository.
repo_slug string required The repository slug or UUID. username string required The user's account ID or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permission_user_get Returns the explicit repository permission for a specific user. 3 params
Returns the explicit repository permission for a specific user.
repo_slug string required The repository slug or UUID. username string required The user's account ID or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permission_user_update Sets the explicit permission for a user on a repository. 4 params
Sets the explicit permission for a user on a repository.
permission string required Permission level: read, write, or admin. repo_slug string required The repository slug or UUID. username string required The user's account ID or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permissions_groups_list Lists all explicit group permissions for a repository. 2 params
Lists all explicit group permissions for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_permissions_users_list Lists all explicit user permissions for a repository. 2 params
Lists all explicit user permissions for a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_repository_update Updates a Bitbucket repository's description, privacy, or other settings. 6 params
Updates a Bitbucket repository's description, privacy, or other settings.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. description string optional New description for the repository. has_issues boolean optional Enable or disable the issue tracker. has_wiki boolean optional Enable or disable the wiki. is_private boolean optional Whether the repository should be private. bitbucket_repository_watchers_list Lists all users watching a repository. 2 params
Lists all users watching a repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_src_get Retrieves metadata (size, type, mimetype, last commit) for a file or directory in a Bitbucket repository at a specific commit. Returns JSON metadata via format=meta. 4 params
Retrieves metadata (size, type, mimetype, last commit) for a file or directory in a Bitbucket repository at a specific commit. Returns JSON metadata via format=meta.
commit string required Branch name, tag, or commit hash. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. path string optional Path to the file or directory within the repository. bitbucket_tag_create Creates a new tag in a Bitbucket repository pointing to a specific commit. 5 params
Creates a new tag in a Bitbucket repository pointing to a specific commit.
name string required Name for the new tag. repo_slug string required The repository slug or UUID. target_hash string required The commit hash to tag. workspace string required The workspace slug or UUID. message string optional Optional message for an annotated tag. bitbucket_tag_delete Deletes a tag from a Bitbucket repository. 3 params
Deletes a tag from a Bitbucket repository.
name string required The tag name to delete. repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_tags_list Returns all tags in a Bitbucket repository. 4 params
Returns all tags in a Bitbucket repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. q string optional Filter query for tags. sort string optional Sort field. bitbucket_user_emails_list Returns all email addresses associated with the authenticated Bitbucket user. 0 params
Returns all email addresses associated with the authenticated Bitbucket user.
bitbucket_user_get Returns the authenticated user's Bitbucket profile including display name, account ID, and account links. 0 params
Returns the authenticated user's Bitbucket profile including display name, account ID, and account links.
bitbucket_version_get Returns a specific version by ID from the issue tracker. 3 params
Returns a specific version by ID from the issue tracker.
repo_slug string required The repository slug or UUID. version_id string required The numeric ID of the version. workspace string required The workspace slug or UUID. bitbucket_versions_list Lists all versions defined for a repository's issue tracker. 2 params
Lists all versions defined for a repository's issue tracker.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_webhook_create Creates a new webhook on a Bitbucket repository to receive event notifications at a specified URL. 7 params
Creates a new webhook on a Bitbucket repository to receive event notifications at a specified URL.
events string required JSON array of event types to subscribe to, e.g. ["repo:push","pullrequest:created"]. repo_slug string required The repository slug or UUID. url string required The URL to receive webhook payloads. workspace string required The workspace slug or UUID. active boolean optional Whether the webhook is active. description string optional A human-readable description of the webhook. secret string optional Secret string used to compute the HMAC signature of webhook payloads. bitbucket_webhook_delete Deletes a webhook from a Bitbucket repository. 3 params
Deletes a webhook from a Bitbucket repository.
repo_slug string required The repository slug or UUID. uid string required The UID of the webhook to delete. workspace string required The workspace slug or UUID. bitbucket_webhook_get Returns the details of a specific webhook installed on a Bitbucket repository. 3 params
Returns the details of a specific webhook installed on a Bitbucket repository.
repo_slug string required The repository slug or UUID. uid string required The UID of the webhook. workspace string required The workspace slug or UUID. bitbucket_webhook_update Updates an existing webhook on a Bitbucket repository, including its URL, events, and active status. 7 params
Updates an existing webhook on a Bitbucket repository, including its URL, events, and active status.
events string required JSON array of event types to subscribe to, e.g. ["repo:push","pullrequest:created"]. repo_slug string required The repository slug or UUID. uid string required The UID of the webhook to update. url string required The new URL to receive webhook payloads. workspace string required The workspace slug or UUID. active boolean optional Whether the webhook is active. description string optional A human-readable description of the webhook. bitbucket_webhooks_list Returns a list of webhooks installed on a Bitbucket repository. 2 params
Returns a list of webhooks installed on a Bitbucket repository.
repo_slug string required The repository slug or UUID. workspace string required The workspace slug or UUID. bitbucket_workspace_get Returns details of a specific Bitbucket workspace by its slug. 1 param
Returns details of a specific Bitbucket workspace by its slug.
workspace string required The workspace slug or UUID. bitbucket_workspace_members_list Returns all members of a Bitbucket workspace. 1 param
Returns all members of a Bitbucket workspace.
workspace string required The workspace slug or UUID. bitbucket_workspace_pipeline_variable_create Creates a new pipeline variable at the workspace level. 4 params
Creates a new pipeline variable at the workspace level.
key string required Variable name. value string required Variable value. workspace string required The workspace slug or UUID. secured string optional Whether the variable is secret (masked in logs). bitbucket_workspace_pipeline_variable_delete Deletes a workspace pipeline variable. 2 params
Deletes a workspace pipeline variable.
variable_uuid string required The UUID of the variable. workspace string required The workspace slug or UUID. bitbucket_workspace_pipeline_variable_get Returns a specific workspace pipeline variable by UUID. 2 params
Returns a specific workspace pipeline variable by UUID.
variable_uuid string required The UUID of the variable. workspace string required The workspace slug or UUID. bitbucket_workspace_pipeline_variable_update Updates a workspace pipeline variable. 5 params
Updates a workspace pipeline variable.
key string required Variable name. value string required Variable value. variable_uuid string required The UUID of the variable. workspace string required The workspace slug or UUID. secured string optional Whether the variable is secret. bitbucket_workspace_pipeline_variables_list Lists all pipeline variables defined at the workspace level. 1 param
Lists all pipeline variables defined at the workspace level.
workspace string required The workspace slug or UUID. bitbucket_workspace_project_create Creates a new project in a workspace. 5 params
Creates a new project in a workspace.
key string required Unique key for the project (uppercase letters/numbers). name string required Name of the project. workspace string required The workspace slug or UUID. description string optional Description of the project. is_private string optional Whether the project is private. bitbucket_workspace_project_delete Deletes a project from a workspace. 2 params
Deletes a project from a workspace.
project_key string required The project key. workspace string required The workspace slug or UUID. bitbucket_workspace_project_get Returns a specific project from a workspace by project key. 2 params
Returns a specific project from a workspace by project key.
project_key string required The project key (e.g. PROJ). workspace string required The workspace slug or UUID. bitbucket_workspace_project_update Updates an existing project in a workspace. 6 params
Updates an existing project in a workspace.
key string required The project key to set in the request body. To keep the existing key, pass the same value as project_key. To rename the key, pass the new key here. name string required Updated name of the project. project_key string required The current project key used in the URL path to identify which project to update (e.g. PROJ). workspace string required The workspace slug or UUID. description string optional Updated description. is_private string optional Whether the project is private. bitbucket_workspace_projects_list Lists all projects in a workspace. 1 param
Lists all projects in a workspace.
workspace string required The workspace slug or UUID. bitbucket_workspace_search_code Searches for code across all repositories in a workspace. 4 params
Searches for code across all repositories in a workspace.
search_query string required Code search query string. workspace string required The workspace slug or UUID. page integer optional Page number for pagination. pagelen integer optional Number of results per page (max 100).