Bitbucket

Bitbucket is a cloud-based Git repository hosting service by Atlassian. It supports code collaboration, CI/CD pipelines, pull requests, and deployment environments for teams.

Supports authentication: OAuth 2.0

Set up the agent 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.

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

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

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

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

     

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

     

   Callback URL must match exactly

   Bitbucket performs an exact string match on the callback URL. Any mismatch — including a trailing slash — will cause the OAuth flow to fail. Make sure you paste the URL exactly as shown in Scalekit.

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

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

   Request only the scopes you need

   Bitbucket displays the requested scopes on the user consent screen. Request only the minimum scopes your agent requires — this builds user trust and reduces the attack surface if a token is compromised.

Usage

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

Node.js

import { ScalekitClient } from '@scalekit-sdk/node';
import 'dotenv/config';

const connectionName = 'bitbucket'; // get your connection name from connection configurations
const identifier = 'user_123';      // your unique user identifier

// Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
const 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 user
const { 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 proxy
const user = await actions.request({
  connectionName,
  identifier,
  path: '/2.0/user',
  method: 'GET',
});
console.log(user);

Python

import scalekit.client, os
from dotenv import load_dotenv
load_dotenv()

connection_name = "bitbucket"  # get your connection name from connection configurations
identifier = "user_123"        # your unique user identifier

# Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
scalekit_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 user
link_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 proxy
user = actions.request(
    connection_name=connection_name,
    identifier=identifier,
    path="/2.0/user",
    method="GET"
)
print(user)

Scalekit tools

Tool list

The 148 tools are grouped by the OAuth scope they require. Grant these scopes when creating your Bitbucket OAuth consumer in the setup guide.

Scope	What it covers
account	Authenticated user’s profile and email addresses
repository	Read access to repositories, branches, commits, diffs, and source files
repository:write	Create and delete branches, tags, commits, and repository settings
repository:admin	Branch restrictions, deploy keys, permission management, repository deletion
pullrequest	Read pull requests, comments, tasks, and commit statuses
pullrequest:write	Create, approve, merge, decline pull requests and manage PR tasks
issue	Read issues, components, milestones, and versions (requires issue tracker enabled)
issue:write	Create, update, and delete issues, comments, votes, and watches
pipeline	Read pipeline runs, schedules, steps, logs, variables, and deployment environments
pipeline:write	Trigger, stop, and configure pipelines, schedules, variables, and environments
webhook	Create, read, update, and delete repository webhooks

Enable Pipelines in repository settings

Pipeline tools (bitbucket_pipeline_*, bitbucket_deployment_*, bitbucket_environment_*) require Pipelines to be enabled for the repository in Bitbucket → Repository Settings → Pipelines. Calling these tools on a repository without Pipelines enabled returns a 404.

Issue tracker must be enabled

Issue tools (bitbucket_issue_*, bitbucket_component_*, bitbucket_milestone_*, bitbucket_version_*) require the repository’s Issue tracker to be enabled in Bitbucket → Repository Settings → Issue Tracker. The issue and issue:write OAuth scopes must also be granted.

bitbucket_branch_create

Creates a new branch in a Bitbucket repository from a specified commit hash or branch. Requires repository:write scope.

Name	Type	Required	Description
name	string	Yes	New branch name
repo_slug	string	Yes	Repository slug or UUID
target_hash	string	Yes	Commit SHA to branch from
workspace	string	Yes	Workspace slug or UUID

bitbucket_branch_delete

Deletes a branch from a Bitbucket repository. Requires repository:write scope.

Name	Type	Required	Description
name	string	Yes	Branch name to delete
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_branch_get

Returns details of a specific branch in a Bitbucket repository. Requires repository scope.

Name	Type	Required	Description
name	string	Yes	Branch name (e.g. main)
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_branch_restriction_create

Creates a branch permission rule for a repository (e.g. restrict who can push to main). Requires repository:admin scope.

Name	Type	Required	Description
kind	string	Yes	Restriction type (e.g. push)
pattern	string	Yes	Branch pattern to restrict (e.g. main)
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
groups	string | null	No	Group slugs to exempt from the restriction
users	string | null	No	User account IDs to exempt from the restriction
value	string	No	Numeric threshold (e.g. minimum approvals)

bitbucket_branch_restriction_delete

Deletes a branch permission rule. Requires repository:admin scope.

Name	Type	Required	Description
id	string	Yes	Branch restriction ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_branch_restriction_get

Returns a specific branch permission rule by ID. Requires repository:admin scope.

Name	Type	Required	Description
id	string	Yes	Branch restriction ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_branch_restriction_update

Updates a branch permission rule. Requires repository:admin scope.

Name	Type	Required	Description
id	string	Yes	Branch restriction ID
kind	string	Yes	Restriction type (e.g. push)
pattern	string	Yes	Branch pattern to restrict
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
value	string	No	Numeric threshold (e.g. minimum approvals)

bitbucket_branch_restrictions_list

Lists branch permission rules for a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_branches_list

Returns all branches in a Bitbucket repository. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
q	string | null	No	Filter query string
sort	string | null	No	Sort field

bitbucket_branching_model_get

Returns the effective branching model for a repository (e.g. Gitflow configuration). Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_branching_model_settings_get

Returns the branching model configuration settings for a repository. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_branching_model_settings_update

Updates the branching model configuration settings for a repository. Requires repository:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
development_branch	string | null	No	Development branch name (e.g. develop)
production_branch	string | null	No	Production branch name (e.g. main)

bitbucket_commit_approve

Approves a specific commit in a Bitbucket repository. Requires repository:write scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_build_status_create

Creates a build status for a specific commit. Used to report CI/CD pipeline results back to Bitbucket. Requires pipeline:write scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
key	string	Yes	Unique build key identifying the pipeline
state	string	Yes	Build state: INPROGRESS, SUCCESSFUL, or FAILED
url	string	Yes	URL linking to the build result
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
description	string | null	No	Human-readable build description
name	string | null	No	Display name for the build

bitbucket_commit_build_status_get

Returns the build status for a specific commit and build key. Requires pipeline scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
key	string	Yes	Build key identifying the pipeline
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_build_status_update

Updates an existing build status for a specific commit and key. Requires pipeline:write scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
key	string	Yes	Build key identifying the pipeline
state	string	Yes	Build state: INPROGRESS, SUCCESSFUL, or FAILED
url	string	Yes	URL linking to the build result
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
description	string | null	No	Human-readable build description
name	string | null	No	Display name for the build

bitbucket_commit_comment_create

Creates a new comment on a specific commit in a Bitbucket repository. Requires repository:write scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
content	string	Yes	Comment body (Markdown supported)
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_comment_delete

Deletes a specific comment on a commit. Requires repository:write scope.

Name	Type	Required	Description
comment_id	string	Yes	Comment ID
commit	string	Yes	Full or short commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_comment_get

Returns a specific comment on a commit. Requires repository scope.

Name	Type	Required	Description
comment_id	string	Yes	Comment ID
commit	string	Yes	Full or short commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_comment_update

Updates an existing comment on a commit. Requires repository:write scope.

Name	Type	Required	Description
comment_id	string	Yes	Comment ID
commit	string	Yes	Full or short commit SHA
content	string	Yes	Updated comment body
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_comments_list

Lists all comments on a specific commit in a Bitbucket repository. Requires repository scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_get

Returns details of a specific commit including author, message, date, and diff stats. Requires repository scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_statuses_list

Lists all statuses (build results) for a specific commit. Requires pipeline scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commit_unapprove

Removes an approval from a specific commit. Requires repository:write scope.

Name	Type	Required	Description
commit	string	Yes	Full or short commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_commits_list

Returns a list of commits for a repository, optionally filtered by branch. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
branch	string | null	No	Branch, tag, or commit hash to filter by

bitbucket_component_get

Returns a specific component by ID from the repository’s issue tracker. Requires issue scope.

Name	Type	Required	Description
component_id	string	Yes	Component ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_components_list

Lists all components defined for a repository’s issue tracker. Requires issue scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_default_reviewer_add

Adds a user as a default reviewer for pull requests in a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
username	string	Yes	User account UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_default_reviewer_get

Checks if a user is a default reviewer for a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
username	string	Yes	User account UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_default_reviewer_remove

Removes a user from the default reviewers for a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
username	string	Yes	User account UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_default_reviewers_list

Lists all default reviewers for a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	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. Requires repository:admin scope.

Name	Type	Required	Description
key	string	Yes	SSH public key (e.g. ssh-rsa AAAA...)
label	string	Yes	Descriptive label for this key
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_deploy_key_delete

Removes a deploy key from a Bitbucket repository. Requires repository:admin scope.

Name	Type	Required	Description
key_id	integer	Yes	Deploy key ID from list deploy keys response
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_deploy_keys_list

Returns a list of deploy keys (SSH keys) configured on a Bitbucket repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_deployment_get

Returns a specific deployment by UUID. Requires pipeline scope.

Name	Type	Required	Description
deployment_uuid	string	Yes	Deployment UUID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_deployment_variable_create

Creates a new variable for a deployment environment. Requires pipeline:write scope.

Name	Type	Required	Description
environment_uuid	string	Yes	Deployment environment UUID
key	string	Yes	Variable name
value	string	Yes	Variable value
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
secured	string	No	Set to true to mask the value in logs

bitbucket_deployment_variable_delete

Deletes a variable from a deployment environment. Requires pipeline:write scope.

Name	Type	Required	Description
environment_uuid	string	Yes	Deployment environment UUID
variable_uuid	string	Yes	Variable UUID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_deployment_variable_update

Updates an existing variable for a deployment environment. Requires pipeline:write scope.

Name	Type	Required	Description
environment_uuid	string	Yes	Deployment environment UUID
variable_uuid	string	Yes	Variable UUID
key	string	Yes	Variable name
value	string	Yes	New variable value
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
secured	string	No	Set to true to mask the value in logs

bitbucket_deployment_variables_list

Lists all variables for a deployment environment. Requires pipeline scope.

Name	Type	Required	Description
environment_uuid	string	Yes	Deployment environment UUID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_deployments_list

Lists all deployments for a repository. Requires pipeline scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_diff_get

Returns a JSON summary of file changes for a given commit spec (e.g. main..feature-branch). Shows which files were added, modified, or deleted with line counts. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
spec	string	Yes	Commit spec, e.g. main..feature-branch or abc123..def456
workspace	string	Yes	Workspace slug or UUID
path	string | null	No	Optional file path to restrict the diff

bitbucket_diffstat_get

Returns diff stats between two commits or a branch/commit spec in a repository. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
spec	string	Yes	Commit spec, e.g. main..feature-branch
workspace	string	Yes	Workspace slug or UUID

bitbucket_download_delete

Deletes a specific download artifact from a repository. Requires repository:write scope.

Name	Type	Required	Description
filename	string	Yes	Filename of the download artifact
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_downloads_list

Lists all download artifacts for a repository. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_environment_create

Creates a new deployment environment for a repository (e.g. Test, Staging, Production). Requires pipeline:write scope.

Name	Type	Required	Description
environment_type	string	Yes	Environment type: Production, Staging, or Test
name	string	Yes	Display name for the environment
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_environment_delete

Deletes a deployment environment by UUID. Requires pipeline:write scope.

Name	Type	Required	Description
environment_uuid	string	Yes	Deployment environment UUID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_environment_get

Returns a specific deployment environment by UUID. Requires pipeline scope.

Name	Type	Required	Description
environment_uuid	string	Yes	Deployment environment UUID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_environments_list

Lists all deployment environments for a repository (e.g. Test, Staging, Production). Requires pipeline scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_file_history_list

Lists the commits that modified a specific file path. Requires repository scope.

Name	Type	Required	Description
commit	string	Yes	Branch name, tag, or commit SHA to start from
path	string	Yes	File path to get history for (e.g. src/main.py)
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_comment_create

Posts a new comment on a Bitbucket issue. Requires issue:write scope.

Name	Type	Required	Description
content	string	Yes	Comment body
issue_id	integer	Yes	Numeric issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_comment_delete

Deletes a specific comment on an issue. Requires issue:write scope.

Name	Type	Required	Description
comment_id	string	Yes	Comment ID
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_comment_update

Updates an existing comment on an issue. Requires issue:write scope.

Name	Type	Required	Description
comment_id	string	Yes	Comment ID
content	string	Yes	Updated comment body
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_comments_list

Returns all comments on a Bitbucket issue. Requires issue scope.

Name	Type	Required	Description
issue_id	integer	Yes	Numeric issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_create

Creates a new issue in a Bitbucket repository’s issue tracker. Requires issue:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
title	string	Yes	Issue title
workspace	string	Yes	Workspace slug or UUID
assignee_account_id	string | null	No	User account ID to assign the issue to
content	string | null	No	Issue description
kind	string | null	No	Issue kind: bug, enhancement, proposal, or task
priority	string | null	No	Issue priority level

bitbucket_issue_delete

Deletes an issue from a Bitbucket repository’s issue tracker. Requires issue:write scope.

Name	Type	Required	Description
issue_id	integer	Yes	Numeric issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_get

Returns details of a specific issue in a Bitbucket repository. Requires issue scope.

Name	Type	Required	Description
issue_id	integer	Yes	Numeric issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_unvote

Removes a vote from an issue. Requires issue:write scope.

Name	Type	Required	Description
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_unwatch

Stops watching an issue to stop receiving notifications. Requires issue:write scope.

Name	Type	Required	Description
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_update

Updates an existing issue in a Bitbucket repository. Requires issue:write scope.

Name	Type	Required	Description
issue_id	integer	Yes	Numeric issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
content	string | null	No	Updated issue description
kind	string | null	No	Issue kind
priority	string | null	No	Issue priority level
status	string | null	No	Issue status
title	string | null	No	Updated issue title

bitbucket_issue_vote

Casts a vote for an issue. Requires issue:write scope.

Name	Type	Required	Description
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_vote_get

Checks if the authenticated user has voted for an issue. Requires issue scope.

Name	Type	Required	Description
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_watch

Starts watching an issue to receive notifications. Requires issue:write scope.

Name	Type	Required	Description
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issue_watch_get

Checks if the authenticated user is watching an issue. Requires issue scope.

Name	Type	Required	Description
issue_id	string	Yes	Issue ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_issues_list

Returns all issues in a Bitbucket repository’s issue tracker. Requires issue scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
q	string | null	No	Filter query string
sort	string | null	No	Sort field

bitbucket_merge_base_get

Returns the common ancestor (merge base) between two commits. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
revspec	string	Yes	Two commit SHAs separated by .. (e.g. abc123..def456)
workspace	string	Yes	Workspace slug or UUID

bitbucket_milestone_get

Returns a specific milestone by ID from the issue tracker. Requires issue scope.

Name	Type	Required	Description
milestone_id	string	Yes	Milestone ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_milestones_list

Lists all milestones defined for a repository’s issue tracker. Requires issue scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_get

Returns details of a specific Bitbucket pipeline run by its UUID. Requires pipeline scope.

Name	Type	Required	Description
pipeline_uuid	string	Yes	Pipeline UUID from list pipelines response
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_schedule_create

Creates a new scheduled pipeline for a repository using a cron expression. Requires pipeline:write scope.

Name	Type	Required	Description
branch	string	Yes	Branch to run the scheduled pipeline on
cron_expression	string	Yes	Cron schedule expression (e.g. 0 0 * * * for daily at midnight)
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
enabled	string	No	Set to false to disable the schedule

bitbucket_pipeline_schedule_delete

Deletes a pipeline schedule. Requires pipeline:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
schedule_uuid	string	Yes	Pipeline schedule UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_schedule_get

Returns a specific pipeline schedule by UUID. Requires pipeline scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
schedule_uuid	string	Yes	Pipeline schedule UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_schedule_update

Updates a pipeline schedule’s cron expression or enabled status. Requires pipeline:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
schedule_uuid	string	Yes	Pipeline schedule UUID
workspace	string	Yes	Workspace slug or UUID
cron_expression	string | null	No	New cron schedule expression
enabled	string	No	Set to false to disable the schedule

bitbucket_pipeline_schedules_list

Lists all pipeline schedules for a repository. Requires pipeline scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_step_log_get

Retrieves the log output for a specific step of a Bitbucket pipeline run. Requires pipeline scope.

Name	Type	Required	Description
pipeline_uuid	string	Yes	Pipeline UUID
repo_slug	string	Yes	Repository slug or UUID
step_uuid	string	Yes	Step UUID from list pipeline steps
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_steps_list

Returns a list of steps for a specific Bitbucket pipeline run. Requires pipeline scope.

Name	Type	Required	Description
pipeline_uuid	string	Yes	Pipeline UUID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_stop

Stops a running Bitbucket pipeline. Requires pipeline:write scope.

Name	Type	Required	Description
pipeline_uuid	string	Yes	Pipeline UUID from list or trigger response
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_trigger

Triggers a new Bitbucket pipeline run for a specific branch, tag, or commit. Requires pipeline:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
branch	string | null	No	Branch to trigger the pipeline on
commit_hash	string | null	No	Commit SHA to run the pipeline at
pipeline_name	string | null	No	Custom pipeline key from bitbucket-pipelines.yml
variables	string | null	No	Array of variable objects with key and value fields

bitbucket_pipeline_variable_create

Creates a new pipeline variable for a Bitbucket repository. Requires pipeline:write scope.

Name	Type	Required	Description
key	string	Yes	Variable name
value	string	Yes	Variable value
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
secured	boolean | null	No	Set to true to mask this variable in pipeline logs

bitbucket_pipeline_variable_delete

Deletes a pipeline variable from a Bitbucket repository. Requires pipeline:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
variable_uuid	string	Yes	Variable UUID from list pipeline variables
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipeline_variable_update

Updates an existing pipeline variable for a Bitbucket repository. Requires pipeline:write scope.

Name	Type	Required	Description
key	string	Yes	New variable name
value	string	Yes	New variable value
variable_uuid	string	Yes	Variable UUID from list pipeline variables
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
secured	boolean | null	No	Set to true to mask this variable in pipeline logs

bitbucket_pipeline_variables_list

Returns a list of pipeline variables defined for the repository. Requires pipeline scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pipelines_list

Returns pipeline runs for a Bitbucket repository, optionally filtered by status or branch. Requires pipeline scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
sort	string | null	No	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. Requires pullrequest scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_approve

Approves a pull request on behalf of the authenticated user. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_comment_create

Posts a new comment on a pull request. Requires pullrequest:write scope.

Name	Type	Required	Description
content	string	Yes	Comment body text
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_comment_delete

Deletes a comment from a pull request. Requires pullrequest:write scope.

Name	Type	Required	Description
comment_id	integer	Yes	Numeric comment ID
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_comments_list

Returns all comments on a pull request. Requires pullrequest scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_commits_list

Returns all commits included in a pull request. Requires pullrequest scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_create

Creates a new pull request in a Bitbucket repository. Requires pullrequest:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
source_branch	string	Yes	Branch containing the changes
title	string	Yes	Pull request title
workspace	string	Yes	Workspace slug or UUID
close_source_branch	boolean | null	No	Set to true to delete source branch on merge
description	string | null	No	PR description (Markdown supported)
destination_branch	string | null	No	Target branch to merge into (e.g. main)
reviewers	string | null	No	Array of reviewer objects with uuid field

bitbucket_pull_request_decline

Declines (rejects) an open pull request in a Bitbucket repository. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_diffstat_get

Returns a JSON diffstat for a pull request. Get commit hashes from bitbucket_pull_request_get (source.commit.hash and destination.commit.hash). Requires pullrequest scope.

Name	Type	Required	Description
dest_commit	string	Yes	Destination commit hash
repo_slug	string	Yes	Repository slug or UUID
source_commit	string	Yes	Source commit hash
workspace	string	Yes	Workspace slug or UUID
pull_request_id	string | null	No	Pull request ID

bitbucket_pull_request_get

Returns details of a specific pull request including title, description, source/destination branches, state, and reviewers. Requires pullrequest scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_merge

Merges a pull request in a Bitbucket repository. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
close_source_branch	boolean | null	No	Set to true to delete source branch on merge
merge_strategy	string | null	No	Merge strategy: merge_commit, squash, or fast_forward
message	string | null	No	Merge commit message

bitbucket_pull_request_remove_request_changes

Removes a change request from a pull request, unblocking it from merging. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_request_changes

Requests changes on a pull request, blocking it from merging until changes are addressed. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_statuses_list

Lists all commit statuses for the commits in a pull request. Requires pullrequest scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_task_create

Creates a new task on a pull request. Requires pullrequest:write scope.

Name	Type	Required	Description
content	string	Yes	Task description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
pending	string	No	Set to true to mark the task as pending

bitbucket_pull_request_task_delete

Deletes a task from a pull request. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
task_id	string	Yes	Task ID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_task_get

Returns a specific task on a pull request. Requires pullrequest scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
task_id	string	Yes	Task ID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_task_update

Updates a task on a pull request (e.g. resolve/reopen or change content). Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
task_id	string	Yes	Task ID
workspace	string	Yes	Workspace slug or UUID
content	string | null	No	Updated task description
pending	string	No	Set to false to mark the task as resolved

bitbucket_pull_request_tasks_list

Lists all tasks on a pull request. Requires pullrequest scope.

Name	Type	Required	Description
pull_request_id	string	Yes	Pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_unapprove

Removes the authenticated user’s approval from a pull request. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_request_update

Updates a pull request’s title, description, reviewers, or destination branch. Requires pullrequest:write scope.

Name	Type	Required	Description
pull_request_id	integer	Yes	Numeric pull request ID
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
description	string | null	No	Updated PR description
destination_branch	string | null	No	Updated target branch
title	string | null	No	Updated PR title

bitbucket_pull_requests_activity_list

Lists overall activity for all pull requests in a repository. Requires pullrequest scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_pull_requests_list

Returns pull requests for a Bitbucket repository, filterable by state. Requires pullrequest scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
q	string | null	No	Filter query string
sort	string | null	No	Sort field (e.g. -updated_on)
state	string | null	No	PR state filter: OPEN, MERGED, or DECLINED

bitbucket_refs_list

Lists all branches and tags (refs) for a repository. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repositories_list

Returns all repositories in a Bitbucket workspace. Requires repository scope.

Name	Type	Required	Description
workspace	string	Yes	Workspace slug or UUID
q	string | null	No	Filter query string
sort	string | null	No	Sort field, prefix with - for descending

bitbucket_repository_create

Creates a new Bitbucket repository in the specified workspace. Requires repository:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	URL-friendly repository name
workspace	string	Yes	Workspace slug or UUID
description	string | null	No	Short description of the repository
has_issues	boolean | null	No	Set to true to enable the issue tracker
has_wiki	boolean | null	No	Set to true to enable the wiki
is_private	boolean | null	No	Set to false to make the repository public
project_key	string | null	No	Project key to associate the repository with (e.g. PROJ)
scm	string | null	No	Source control type: git or hg

bitbucket_repository_delete

Permanently deletes a Bitbucket repository and all its data. Requires repository:admin scope.

Destructive operation

This permanently deletes the repository and all associated data including commits, branches, pull requests, and pipelines. This action cannot be undone.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_fork

Forks a Bitbucket repository into the authenticated user’s workspace or a specified workspace. Requires repository:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Source repository slug or UUID
workspace	string	Yes	Source workspace slug or UUID
is_private	boolean | null	No	Set to true for a private fork
name	string | null	No	Name for the forked repository
workspace_destination	string | null	No	Destination workspace slug for the fork

bitbucket_repository_get

Returns details of a specific Bitbucket repository including description, language, size, and clone URLs. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permission_group_delete

Removes a group’s explicit permission from a repository. Requires repository:admin scope.

Name	Type	Required	Description
group_slug	string	Yes	Group slug (e.g. developers)
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permission_group_get

Returns the explicit repository permission for a specific group. Requires repository:admin scope.

Name	Type	Required	Description
group_slug	string	Yes	Group slug (e.g. developers)
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permission_group_update

Sets the explicit permission for a group on a repository. Requires repository:admin scope.

Name	Type	Required	Description
group_slug	string	Yes	Group slug (e.g. developers)
permission	string	Yes	Permission level: read, write, or admin
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permission_user_delete

Removes a user’s explicit permission from a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
username	string	Yes	User account UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permission_user_get

Returns the explicit repository permission for a specific user. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
username	string	Yes	User account UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permission_user_update

Sets the explicit permission for a user on a repository. Requires repository:admin scope.

Name	Type	Required	Description
permission	string	Yes	Permission level: read, write, or admin
repo_slug	string	Yes	Repository slug or UUID
username	string	Yes	User account UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permissions_groups_list

Lists all explicit group permissions for a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_permissions_users_list

Lists all explicit user permissions for a repository. Requires repository:admin scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_repository_update

Updates a Bitbucket repository’s description, privacy settings, or other configuration. Requires repository:write scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
description	string | null	No	Updated repository description
has_issues	boolean | null	No	Set to true to enable issues
has_wiki	boolean | null	No	Set to true to enable wiki
is_private	boolean | null	No	Set to true for private, false for public

bitbucket_repository_watchers_list

Lists all users watching a repository. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_src_get

Retrieves metadata (size, type, MIME type, last commit) for a file or directory in a repository at a specific commit. Requires repository scope.

Name	Type	Required	Description
commit	string	Yes	Branch name, tag, or commit SHA
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
path	string | null	No	File or directory path (e.g. src/app.py or README.md)

bitbucket_tag_create

Creates a new tag in a Bitbucket repository pointing to a specific commit. Requires repository:write scope.

Name	Type	Required	Description
name	string	Yes	Tag name (e.g. v1.0.0)
repo_slug	string	Yes	Repository slug or UUID
target_hash	string	Yes	Commit SHA to tag
workspace	string	Yes	Workspace slug or UUID
message	string | null	No	Optional annotation message for the tag

bitbucket_tag_delete

Deletes a tag from a Bitbucket repository. Requires repository:write scope.

Name	Type	Required	Description
name	string	Yes	Tag name to delete
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_tags_list

Returns all tags in a Bitbucket repository. Requires repository scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID
q	string | null	No	Filter query (e.g. name~"v1")
sort	string | null	No	Sort field, prefix with - for descending

bitbucket_user_emails_list

Returns all email addresses associated with the authenticated Bitbucket user. Requires account scope.

bitbucket_user_get

Returns the authenticated user’s Bitbucket profile including display name, account ID, and account links. Requires account scope.

bitbucket_version_get

Returns a specific version by ID from the issue tracker. Requires issue scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
version_id	string	Yes	Version ID
workspace	string	Yes	Workspace slug or UUID

bitbucket_versions_list

Lists all versions defined for a repository’s issue tracker. Requires issue scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_webhook_create

Creates a new webhook on a Bitbucket repository to receive event notifications at a specified URL. Requires webhook scope.

Name	Type	Required	Description
events	string	Yes	Array of Bitbucket event identifiers (e.g. repo:push, pullrequest:created)
repo_slug	string	Yes	Repository slug or UUID
url	string	Yes	HTTPS URL that will receive webhook POST requests
workspace	string	Yes	Workspace slug or UUID
active	boolean | null	No	Set to false to disable the webhook
description	string | null	No	Optional description for the webhook
secret	string | null	No	Optional shared secret for payload signature verification

bitbucket_webhook_delete

Deletes a webhook from a Bitbucket repository. Requires webhook scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
uid	string	Yes	Webhook UID from list webhooks response
workspace	string	Yes	Workspace slug or UUID

bitbucket_webhook_get

Returns the details of a specific webhook installed on a Bitbucket repository. Requires webhook scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
uid	string	Yes	Webhook UID from list webhooks response
workspace	string	Yes	Workspace slug or UUID

bitbucket_webhook_update

Updates an existing webhook on a Bitbucket repository, including its URL, events, and active status. Requires webhook scope.

Name	Type	Required	Description
events	string	Yes	Array of Bitbucket event identifiers
repo_slug	string	Yes	Repository slug or UUID
uid	string	Yes	Webhook UID from list webhooks response
url	string	Yes	HTTPS URL that will receive webhook POST requests
workspace	string	Yes	Workspace slug or UUID
active	boolean | null	No	Set to false to disable the webhook
description	string | null	No	Optional description for the webhook

bitbucket_webhooks_list

Returns a list of webhooks installed on a Bitbucket repository. Requires webhook scope.

Name	Type	Required	Description
repo_slug	string	Yes	Repository slug or UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_get

Returns details of a specific Bitbucket workspace by its slug. Requires repository scope.

Name	Type	Required	Description
workspace	string	Yes	Workspace slug (e.g. myteam) or UUID

bitbucket_workspace_members_list

Returns all members of a Bitbucket workspace. Requires repository scope.

Name	Type	Required	Description
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_pipeline_variable_create

Creates a new pipeline variable at the workspace level, available to all repositories in the workspace. Requires pipeline:write scope.

Name	Type	Required	Description
key	string	Yes	Variable name
value	string	Yes	Variable value
workspace	string	Yes	Workspace slug or UUID
secured	string	No	Set to true to mask the value in pipeline logs

bitbucket_workspace_pipeline_variable_delete

Deletes a workspace pipeline variable. Requires pipeline:write scope.

Name	Type	Required	Description
variable_uuid	string	Yes	Variable UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_pipeline_variable_get

Returns a specific workspace pipeline variable by UUID. Requires pipeline scope.

Name	Type	Required	Description
variable_uuid	string	Yes	Variable UUID
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_pipeline_variable_update

Updates a workspace pipeline variable. Requires pipeline:write scope.

Name	Type	Required	Description
key	string	Yes	Variable name
value	string	Yes	New variable value
variable_uuid	string	Yes	Variable UUID
workspace	string	Yes	Workspace slug or UUID
secured	string	No	Set to true to mask the value in pipeline logs

bitbucket_workspace_pipeline_variables_list

Lists all pipeline variables defined at the workspace level. Requires pipeline scope.

Name	Type	Required	Description
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_project_create

Creates a new project in a workspace. Requires repository:admin scope.

Name	Type	Required	Description
key	string	Yes	Project key (e.g. PROJ)
name	string	Yes	Project display name
workspace	string	Yes	Workspace slug or UUID
description	string | null	No	Project description
is_private	string	No	Set to false to make the project public

bitbucket_workspace_project_delete

Deletes a project from a workspace. Requires repository:admin scope.

Name	Type	Required	Description
project_key	string	Yes	Project key (e.g. PROJ)
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_project_get

Returns a specific project from a workspace by project key. Requires repository scope.

Name	Type	Required	Description
project_key	string	Yes	Project key (e.g. PROJ)
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_project_update

Updates an existing project in a workspace. Requires repository:admin scope.

Name	Type	Required	Description
key	string	Yes	Project key
name	string	Yes	Updated project name
project_key	string	Yes	Current project key
workspace	string	Yes	Workspace slug or UUID
description	string | null	No	Updated project description
is_private	string	No	Set to false to make the project public

bitbucket_workspace_projects_list

Lists all projects in a workspace. Requires repository scope.

Name	Type	Required	Description
workspace	string	Yes	Workspace slug or UUID

bitbucket_workspace_search_code

Searches for code across all repositories in a workspace. Requires repository scope.

Name	Type	Required	Description
search_query	string	Yes	Code search query (e.g. def main)
workspace	string	Yes	Workspace slug or UUID
page	integer | null	No	Page number for pagination
pagelen	integer | null	No	Number of results per page (max 100)