Bitbucket | Composio Docs

Overview

SLUG

BITBUCKET

Description

Bitbucket is a Git-based code hosting and collaboration platform supporting private and public repositories, enabling teams to manage and review code through pull requests and integrations

Authentication Details

OAuth2

client_id

stringRequired

client_secret

stringRequired

oauth_redirect_uri

stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add

scopes

stringDefaults to webhook,pullrequest:write,project:admin,runner:write,project:write,snippet:write,team:write,pipeline:variable,repository:delete,repository:admin,account:write,wiki,issue:write

full

stringDefaults to https://api.bitbucket.org/2.0

bearer_token

string

Tools

Create a branch

SLUG: BITBUCKET_CREATE_BRANCH

Creates a new branch in a bitbucket repository from a target commit hash; the branch name must be unique, adhere to bitbucket's naming conventions, and not include the 'refs/heads/' prefix.

Action Parameters

name

stringRequired

repo_slug

stringRequired

target_hash

stringRequired

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create an issue

SLUG: BITBUCKET_CREATE_ISSUE

Creates a new issue in a bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component ids exist.

Action Parameters

assignee

string

component_id

integer

content

stringRequired

due_on

string

kind

string

milestone_id

integer

priority

string

repo_slug

stringRequired

title

stringRequired

version_id

integer

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create an issue comment

SLUG: BITBUCKET_CREATE_ISSUE_COMMENT

Adds a new comment with markdown support to an existing bitbucket issue.

Action Parameters

content

stringRequired

issue_id

stringRequired

repo_slug

stringRequired

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create a pull request

SLUG: BITBUCKET_CREATE_PULL_REQUEST

Creates a new pull request in a specified bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.

Action Parameters

close_source_branch

boolean

description

string

destination_branch

string

repo_slug

stringRequired

reviewers

array

source_branch

stringRequired

title

stringRequired

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create repository

SLUG: BITBUCKET_CREATE_REPOSITORY

Creates a new bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project key` is not provided.

Action Parameters

description

string

fork_policy

stringDefaults to allow_forks

has_issues

booleanDefaults to True

has_wiki

booleanDefaults to True

is_private

booleanDefaults to True

language

string

project_key

string

repo_slug

stringRequired

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Delete issue

SLUG: BITBUCKET_DELETE_ISSUE

Permanently deletes a specific issue, identified by its `issue id`, from the repository specified by `repo slug` within the given `workspace`.

Action Parameters

issue_id

stringRequired

repo_slug

stringRequired

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Delete repository

SLUG: BITBUCKET_DELETE_REPOSITORY

Permanently deletes a specified bitbucket repository; this action is irreversible and does not affect forks.

Action Parameters

repo_slug

stringRequired

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Get current user

SLUG: BITBUCKET_GET_CURRENT_USER

Retrieves the profile information (uuid, display name, links, creation date) for the currently authenticated bitbucket user.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

Get file from repository

SLUG: BITBUCKET_GET_FILE_FROM_REPOSITORY

Retrieves a specific file's content from a bitbucket repository at a given commit (hash, branch, or tag), failing if the file path is invalid for that commit.

Action Parameters

commit

stringRequired

path

stringRequired

repo_slug

stringRequired

workspace

stringRequired

Action Response

commit

stringRequired

data

stringRequired

error

string

path

stringRequired

size

integerRequired

successful

booleanRequired

Get snippet

SLUG: BITBUCKET_GET_SNIPPET

Retrieves a specific bitbucket snippet by its encoded id from an existing workspace, returning its metadata and file structure.

Action Parameters

accept_format

stringDefaults to application/json

encoded_id

stringRequired

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

List pull requests

SLUG: BITBUCKET_LIST_PULL_REQUESTS

Lists pull requests in a specified, accessible bitbucket repository, optionally filtering by state (open, merged, declined).

Action Parameters

page

integer

pagelen

integer

repo_slug

stringRequired

state

string

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

List repositories in workspace

SLUG: BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE

Lists repositories in a specified bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.

Action Parameters

string

role

string

sort

string

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

List workspaces

SLUG: BITBUCKET_LIST_WORKSPACES

Lists bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.

Action Parameters

string

sort

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

List workspace members

SLUG: BITBUCKET_LIST_WORKSPACE_MEMBERS

Lists all members of a specified bitbucket workspace; the workspace must exist.

Action Parameters

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create snippet comment

SLUG: BITBUCKET_CREATE_SNIPPET_COMMENT

Posts a new top-level comment or a threaded reply to an existing comment on a specified bitbucket snippet.

Action Parameters

content

stringRequired

encoded_id

stringRequired

parent_id

integer

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Update an issue

SLUG: BITBUCKET_UPDATE_ISSUE

Updates an existing issue in a bitbucket repository by modifying specified attributes; requires `workspace`, `repo slug`, `issue id`, and at least one attribute to update.

Action Parameters

assignee_account_id

string

component

string

content

string

issue_id

stringRequired

kind

string

milestone

string

priority

string

repo_slug

stringRequired

state

string

title

string

version

string

workspace

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired