Bitbucket

Bitbucket Projects API

Bitbucket Cloud projects make it easier for teams to focus on a goal, product, or process by organizing their repositories.

GitHub OpenAPI

Operations 16

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /workspaces/{workspace}/projects Create a project in a workspace · Create a project in a workspace #
Ask an LLM
“How do I create a new project to group repositories?”
“Can I make a project private when I create it?”
Tell an agent
Create project {name} with key {key} in {workspace}.
Create a private project {name} in {workspace} described as {description}.
DELETE /workspaces/{workspace}/projects/{project_key} Delete a project · Delete a project for a workspace #
Ask an LLM
“How do I delete an empty project?”
“Can I delete a project that still has repositories in it?”
Tell an agent destructive · confirm first
Delete project {project_key} from {workspace}.
Permanently remove the empty project {project_key}.
GET /workspaces/{workspace}/projects/{project_key} Get a project · Get a project for a workspace #
Ask an LLM
“What are the details of a Bitbucket project?”
“Is a given project private?”
Tell an agent
Get project {project_key} in {workspace}.
Show the description and visibility of project {project_key}.
PUT /workspaces/{workspace}/projects/{project_key} Update or create a project by key · Update a project for a workspace #
Ask an LLM
“How do I rename an existing project?”
“Can I change a project's key or description?”
Tell an agent
Rename project {project_key} in {workspace} to {name}.
Update project {project_key}'s description to {description}.
GET /workspaces/{workspace}/projects/{project_key}/default-reviewers List a project's default reviewers · List the default reviewers in a project #
Ask an LLM
“Who gets added automatically as a reviewer on PRs across a project?”
“Which users are project-level default reviewers?”
Tell an agent
List default reviewers for project {project_key} in {workspace}.
Show who is auto-added to PRs in project {project_key}.
DELETE /workspaces/{workspace}/projects/{project_key}/default-reviewers/{selected_user} Remove a project default reviewer · Remove the specific user from the project's default reviewers #
Ask an LLM
“How do I stop someone being auto-added to PRs across a project?”
“Can I take a user off a project's default reviewers?”
Tell an agent destructive · confirm first
Remove {selected_user} from the default reviewers of project {project_key} in {workspace}.
Drop {selected_user} as project default reviewer on {project_key}.
GET /workspaces/{workspace}/projects/{project_key}/default-reviewers/{selected_user} Check a project default reviewer · Get a default reviewer #
Ask an LLM
“Is a particular user a default reviewer for this project?”
“Can I confirm one person is on a project's reviewer list?”
Tell an agent
Check whether {selected_user} is a default reviewer on project {project_key} in {workspace}.
Get project default reviewer {selected_user} for {project_key}.
PUT /workspaces/{workspace}/projects/{project_key}/default-reviewers/{selected_user} Add a project default reviewer · Add the specific user as a default reviewer for the project #
Ask an LLM
“How do I make someone a default reviewer for every repo in a project?”
“Can I add a reviewer to all PRs in a project automatically?”
Tell an agent
Add {selected_user} as a default reviewer on project {project_key} in {workspace}.
Make {selected_user} a project-wide default reviewer for {project_key}.
GET /workspaces/{workspace}/projects/{project_key}/permissions-config/groups List group permissions on a project · List explicit group permissions for a project #
Ask an LLM
“Which groups have explicit access to this project?”
“What permission level does each group hold on a project?”
Tell an agent
List group permissions on project {project_key} in {workspace}.
Show which groups can access project {project_key}.
DELETE /workspaces/{workspace}/projects/{project_key}/permissions-config/groups/{group_slug} Revoke a group's project permission · Delete an explicit group permission for a project #
Ask an LLM
“How do I remove a group's access to a project?”
“Can I revoke a group's explicit permission on a project?”
Tell an agent destructive · confirm first
Revoke group {group_slug}'s permission on project {project_key} in {workspace}.
Remove group {group_slug} from project {project_key} access.
GET /workspaces/{workspace}/projects/{project_key}/permissions-config/groups/{group_slug} Get a group's permission on a project · Get an explicit group permission for a project #
Ask an LLM
“What access does one group have on a project?”
“Does a given group have admin or write on this project?”
Tell an agent
Get the permission of group {group_slug} on project {project_key} in {workspace}.
Check group {group_slug}'s access to {project_key}.
PUT /workspaces/{workspace}/projects/{project_key}/permissions-config/groups/{group_slug} Set a group's permission on a project · Update an explicit group permission for a project #
Ask an LLM
“How do I give a group write access to a project?”
“Can I grant a group create-repo rights on a project?”
Tell an agent
Give group {group_slug} {permission} access to project {project_key} in {workspace}.
Set group {group_slug}'s project permission to {permission}.
GET /workspaces/{workspace}/projects/{project_key}/permissions-config/users List user permissions on a project · List explicit user permissions for a project #
Ask an LLM
“Which individual users have explicit access to a project?”
“Who are the admins of this project?”
Tell an agent
List user permissions on project {project_key} in {workspace}.
Show individual users with access to {project_key}.
DELETE /workspaces/{workspace}/projects/{project_key}/permissions-config/users/{selected_user_id} Revoke a user's project permission · Delete an explicit user permission for a project #
Ask an LLM
“How do I remove one person's explicit access to a project?”
“Can I revoke a user's permission on a project?”
Tell an agent destructive · confirm first
Revoke user {selected_user_id}'s permission on project {project_key} in {workspace}.
Remove user {selected_user_id} from project {project_key} access.
GET /workspaces/{workspace}/projects/{project_key}/permissions-config/users/{selected_user_id} Get a user's permission on a project · Get an explicit user permission for a project #
Ask an LLM
“What access does one person have on a project?”
“Is a given user an admin on this project?”
Tell an agent
Get the permission of user {selected_user_id} on project {project_key} in {workspace}.
Check user {selected_user_id}'s access to {project_key}.
PUT /workspaces/{workspace}/projects/{project_key}/permissions-config/users/{selected_user_id} Set a user's permission on a project · Update an explicit user permission for a project #
Ask an LLM
“How do I give one teammate admin on a project?”
“Can I change a user's project access to read only?”
Tell an agent
Give user {selected_user_id} {permission} access to project {project_key} in {workspace}.
Set user {selected_user_id}'s project permission to {permission}.

Documentation

📖
Documentation
https://developer.atlassian.com/bitbucket/api/2/reference/
📖
Authentication
https://developer.atlassian.com/cloud/bitbucket/rest/intro/#authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/openapi/bitbucket-projects-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/asyncapi/bitbucket-cloud-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-schema/bitbucket-cloud-rest-api-repository-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-schema/bitbucket-cloud-rest-api-pullrequest-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-schema/bitbucket-cloud-rest-api-pipeline-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-schema/bitbucket-cloud-rest-api-commit-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-structure/bitbucket-cloud-rest-api-repository-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-structure/bitbucket-cloud-rest-api-pullrequest-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-structure/bitbucket-cloud-rest-api-pipeline-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/json-structure/bitbucket-cloud-rest-api-commit-structure.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/examples/bitbucket-cloud-rest-api-repository-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/examples/bitbucket-cloud-rest-api-pullrequest-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/examples/bitbucket-cloud-rest-api-pipeline-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/examples/bitbucket-cloud-rest-api-commit-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bitbucket:bitbucket-projects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bitbucket-projects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bitbucket Projects API
  description: Code against the Bitbucket API to automate simple tasks, embed Bitbucket data into your own site, build mobile or desktop apps, or even add custom UI add-ons into Bitbucket itself using the Connect framework.
  version: '2.0'
  termsOfService: https://www.atlassian.com/legal/customer-agreement
  contact:
    name: Bitbucket Support
    url: https://support.atlassian.com/bitbucket-cloud/
    email: support@bitbucket.org
servers:
- url: https://api.bitbucket.org/2.0
tags:


# --- truncated at 32 KB (174 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/openapi/bitbucket-projects-api-openapi.yml