DevOps OAuth 2.0

Bitbucket REST API

Git repository management and CI/CD platform API

Bitbucket REST API enables developers to automate Git repository operations, manage pull requests, configure pipelines, and integrate with Atlassian's DevOps ecosystem. The API provides programmatic access to version control, code review workflows, branch permissions, and deployment automation. Teams use it to build custom integrations, automate release processes, and create developer productivity tools.

Base URL https://api.bitbucket.org/2.0

API Endpoints

Method	Endpoint	Description
GET	`/repositories/{workspace}/{repo_slug}`	Get details about a specific repository including metadata, size, and configuration
GET	`/repositories/{workspace}/{repo_slug}/pullrequests`	List all pull requests for a repository with filtering and pagination options
POST	`/repositories/{workspace}/{repo_slug}/pullrequests`	Create a new pull request with source and destination branches
GET	`/repositories/{workspace}/{repo_slug}/commits`	Retrieve commit history for a repository or specific branch
GET	`/repositories/{workspace}/{repo_slug}/src/{commit}/{path}`	Get file contents at a specific commit or branch
POST	`/repositories/{workspace}/{repo_slug}/webhooks`	Create a webhook to receive events for repository changes and actions
GET	`/repositories/{workspace}/{repo_slug}/pipelines`	List pipeline executions with status, duration, and build information
POST	`/repositories/{workspace}/{repo_slug}/pipelines`	Trigger a new pipeline build for a branch or custom configuration
GET	`/repositories/{workspace}/{repo_slug}/refs/branches`	List all branches in the repository with commit references
POST	`/repositories/{workspace}/{repo_slug}/refs/branches`	Create a new branch from a specific commit or existing branch
GET	`/repositories/{workspace}/{repo_slug}/issues`	Retrieve issues tracked in the repository with filtering options
GET	`/workspaces/{workspace}/projects`	List all projects within a workspace for organization
GET	`/repositories/{workspace}/{repo_slug}/downloads`	List downloadable artifacts and releases for the repository
GET	`/repositories/{workspace}/{repo_slug}/branch-restrictions`	Get branch permission rules and merge restrictions
GET	`/user/permissions/repositories`	List repositories the authenticated user has access to with permission levels

Code Examples

curl -X GET 'https://api.bitbucket.org/2.0/repositories/myworkspace/myrepo/pullrequests' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch('https://api.bitbucket.org/2.0/repositories/myworkspace/myrepo/pullrequests', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Accept': 'application/json'
  }
});

const pullRequests = await response.json();
console.log(pullRequests);

import requests

url = 'https://api.bitbucket.org/2.0/repositories/myworkspace/myrepo/pullrequests'
headers = {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Accept': 'application/json'
}

response = requests.get(url, headers=headers)
pull_requests = response.json()
print(pull_requests)

Connect Bitbucket to AI

Deploy a Bitbucket MCP server on IOX Cloud and connect it to Claude, ChatGPT, Cursor, or any AI client. Your AI assistant gets direct access to Bitbucket through these tools:

create_pull_request Create a new pull request with title, description, source branch, and destination branch

merge_pull_request Merge an approved pull request with specified merge strategy and commit message

get_repository_files Browse and retrieve file contents from a repository at a specific commit or branch

trigger_pipeline Start a CI/CD pipeline build for a branch with optional custom variables

search_code Search code across repositories in a workspace using query patterns

Deploy in 60 seconds

Describe what you need, AI generates the code, and IOX deploys it globally.

Deploy Bitbucket MCP Server →

Bitbucket REST API

API Endpoints

Code Examples

Connect Bitbucket to AI

Deploy in 60 seconds

Related APIs