Bitbucket

Bitbucket Workspaces API

A workspace is where you create repositories, collaborate on your code, and organize different streams of work in your Bitbucket Cloud account. Workspaces replace the use of teams and users in API calls.

GitHub OpenAPI

Operations 18

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

GET /user/permissions/workspaces List my workspace permissions (deprecated) · List workspaces for the current user #
Ask an LLM
“Which workspaces am I in and what is my permission in each, via the older permissions endpoint?”
“Can I filter my workspace memberships to ones where I am owner?”
Tell an agent
List my workspace memberships and permission levels using the deprecated permissions endpoint.
Show workspaces where my permission matches {q}, sorted by {sort}.
GET /user/workspaces List workspaces I can access · List workspaces for the current user #
Ask an LLM
“What workspaces can I access, and am I an admin in any of them?”
“Can I list only the workspaces where I have administrator rights?”
Tell an agent
List every workspace I can access.
Show only workspaces where administrator is {administrator}.
GET /user/workspaces/{workspace}/permission Get my role in a workspace · Get user permission on a workspace #
Ask an LLM
“What is my highest level of access in a particular workspace?”
“Am I an owner or a regular member of a given workspace?”
Tell an agent
Get my effective permission in workspace {workspace}.
Tell me whether I am owner, collaborator or member of {workspace}.
GET /workspaces List my workspaces (deprecated endpoint) · List workspaces for user #
Ask an LLM
“Is there an older endpoint that lists workspaces filtered by my role?”
“Can I search my workspaces by name using the legacy listing?”
Tell an agent
List workspaces where my role is {role} using the legacy endpoint.
Search my workspaces with filter {q} via the deprecated listing.
GET /workspaces/{workspace} Get a workspace · Get a workspace #
Ask an LLM
“What are the name, UUID and privacy of a workspace?”
“How do I look up a single workspace by its slug?”
Tell an agent
Get workspace {workspace}.
Show the details of the workspace {workspace}.
GET /workspaces/{workspace}/hooks List a workspace's webhooks · List webhooks for a workspace #
Ask an LLM
“What webhooks fire for every repository in a workspace?”
“Which workspace-level event subscriptions are installed?”
Tell an agent
List the webhooks installed on workspace {workspace}.
Show all workspace-level webhook subscriptions for {workspace}.
POST /workspaces/{workspace}/hooks Create a workspace-wide webhook · Create a webhook for a workspace #
Ask an LLM
“How do I get one webhook that fires for events in all repos of a workspace?”
“Can I subscribe a URL to pushes across an entire workspace?”
Tell an agent
Create a webhook on workspace {workspace}.
Add a workspace-wide push webhook covering every repo in {workspace}.
DELETE /workspaces/{workspace}/hooks/{uid} Delete a workspace webhook · Delete a webhook for a workspace #
Ask an LLM
“How do I remove a webhook that fires for a whole workspace?”
“Can I delete a workspace-level webhook pointing at a retired service?”
Tell an agent destructive · confirm first
Delete webhook {uid} from workspace {workspace}.
Remove workspace webhook {uid} in {workspace}.
GET /workspaces/{workspace}/hooks/{uid} Get a workspace webhook · Get a webhook for a workspace #
Ask an LLM
“Which events and URL does a given workspace webhook use?”
“Is a specific workspace-level webhook still active?”
Tell an agent
Get webhook {uid} on workspace {workspace}.
Show the configuration of workspace webhook {uid} in {workspace}.
PUT /workspaces/{workspace}/hooks/{uid} Update a workspace webhook · Update a webhook for a workspace #
Ask an LLM
“Can I change the URL or events of a workspace-level webhook?”
“How do I pause a workspace webhook without deleting it?”
Tell an agent
Update webhook {uid} on workspace {workspace}.
Deactivate workspace webhook {uid} in {workspace}.
GET /workspaces/{workspace}/members List members of a workspace · List users in a workspace #
Ask an LLM
“Who belongs to a workspace?”
“Can an admin find a workspace member by their email address?”
Tell an agent
List the members of workspace {workspace}.
Show everyone who belongs to {workspace}.
GET /workspaces/{workspace}/members/{member} Get a user's membership in a workspace · Get user membership for a workspace #
Ask an LLM
“Is a particular person a member of a workspace?”
“How do I fetch one user's workspace membership record?”
Tell an agent
Get the membership of {member} in workspace {workspace}.
Check whether user {member} belongs to {workspace}.
GET /workspaces/{workspace}/permissions List member permission levels in a workspace · List user permissions in a workspace #
Ask an LLM
“Who are the owners versus regular members of a workspace?”
“Can I filter workspace members down to just the owners?”
Tell an agent
List members and their permission levels in workspace {workspace}.
Show members of {workspace} whose permission matches {q}.
GET /workspaces/{workspace}/permissions/repositories List repo permissions across a workspace · List all repository permissions for a workspace #
Ask an LLM
“Who has what access to every repository in a workspace?”
“Can I audit admin access across all of a workspace's repos at once?”
Tell an agent
List all repository permissions across workspace {workspace}.
Audit repo access in {workspace} filtered by {q}.
GET /workspaces/{workspace}/permissions/repositories/{repo_slug} List user permissions on one repo in a workspace · List a repository permissions for a workspace #
Ask an LLM
“What is each user's effective access to one specific repository?”
“Who has write access to a given repo, including via groups?”
Tell an agent
List each user's effective permission on repo {repo_slug} in workspace {workspace}.
Show who can access {workspace}/{repo_slug} filtered by {q}.
GET /workspaces/{workspace}/projects List projects in a workspace · List projects in a workspace #
Ask an LLM
“What projects are set up in a workspace?”
“How are a workspace's repositories grouped into projects?”
Tell an agent
List the projects in workspace {workspace}.
Show every project defined in {workspace}.
GET /workspaces/{workspace}/projects/{project_key} Get a project in a workspace · Get a project for a workspace #
Ask an LLM
“What are the name and description of a project with a given key?”
“How do I look up one project in a workspace?”
Tell an agent
Get project {project_key} in workspace {workspace}.
Show the details of project {project_key} in {workspace}.
GET /workspaces/{workspace}/pullrequests/{selected_user} List a user's pull requests across a workspace · List workspace pull requests for a user #
Ask an LLM
“What pull requests has a given person authored across every repo in a workspace?”
“Can I see one developer's merged PRs workspace-wide, not just in one repository?”
Tell an agent
List open pull requests authored by {selected_user} across workspace {workspace}.
Show {state} PRs by user {selected_user} in every repository of {workspace}.

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-workspaces-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-workspaces-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-workspaces-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bitbucket Workspaces 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 (208 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bitbucket/refs/heads/main/openapi/bitbucket-workspaces-api-openapi.yml