Studio Project workflows for Atlassian Bitbucket Cloud repositories, pull requests, and branch permissions
Bitbucket Cloud is Atlassian's hosted Git repository management service, providing source control, pull requests, branch permissions, and workspace/project organization for teams.
This project provides OpenAPI specs for automating against the Bitbucket Cloud REST API via an Integration Model. The -latest spec is a curated subset covering common CRUD for automation — see OpenAPIs below.
| Asset | Description |
|---|---|
| OpenAPIs/ | Bitbucket Cloud REST API OpenAPI specs — curated -latest plus the full dated spec |
| Studio Projects/Atlassian Bitbucket Cloud | 24 workflows covering common CRUD automation |
| Requirement | Version |
|---|---|
| Itential Platform | 6.x |
| Bitbucket Cloud | REST API 2.0 |
| Bitbucket Cloud Integration Model | Required to build automation against the OpenAPI specs |
Import one of the OpenAPI specs from OpenAPIs/ as an Integration Model in Admin > Integrations, then create an integration pointing at api.bitbucket.org.
Authentication is HTTP Basic auth using a Bitbucket App Password:
Authorization: Basic <base64(username:app_password)> Generate an App Password in Bitbucket under Personal Settings > App passwords.
Note: The upstream spec also defines OAuth2 and a deprecated account API key scheme. Itential Platform supports a single authentication method per integration instance, so this spec is consolidated to the Basic/App Password scheme, which is the standard non-interactive credential for automation.
The instance's authentication/server properties should look like this once configured:
{
"authentication": {
"basic": {
"username": "<your-username>",
"password": "<your-password>"
}
},
"server": {
"protocol": "https",
"host": "api.bitbucket.org",
"base_path": "/2.0"
}
} | Spec | Version | Operations | Description |
|---|---|---|---|
atlassian_bitbucket_cloud-latest.json | latest (curated) | 91 | Trimmed to 91 of 318 upstream operations — see breakdown below |
atlassian_bitbucket_cloud-2.0.json | 2.0 | 318 | Full spec for Bitbucket Cloud REST API 2.0 (Swagger 2.0, as published by the vendor) |
atlassian_bitbucket_cloud-latest.jsonActively-maintained spec (x-vendor-api-version: 2.0). Trimmed to 91 of 318 upstream operations covering common CRUD for automation.
Resources included, by category:
Not included: the legacy Issue Tracker, Snippets, Pipelines/CI-CD (config, variables, caches, schedules, SSH keys, deployments, environments), webhooks, add-ons, code search, SSH keys, properties, and permissions/administration endpoints. Pull the full spec above if you need one of these.
atlassian_bitbucket_cloud-2.0.jsonFull, unmodified vendor spec for Bitbucket Cloud REST API 2.0 (Swagger 2.0, as published by the vendor) — the vendor's complete API surface, preserved as-is. See atlassian_bitbucket_cloud-latest.json above for the curated subset if you just need common CRUD automation.
Backed by the Atlassian Bitbucket Cloud:latest Integration Model (see atlassian_bitbucket_cloud-latest.json above). The project contains 24 workflows organized into 5 folders, one atomic workflow per API operation, covering the common-CRUD subset of the curated spec.
| Folder | Workflows | Scope |
|---|---|---|
| Repositories | List Repositories, Get Repository, Create Repository, Update Repository, Delete Repository | Repository lifecycle |
| Pull Requests | List, Create, Get, Update, Decline, Merge Pull Request | Pull request lifecycle |
| Commits | List Commits, Get Commit, List Commit Comments, Add Commit Comment | Commit history and comments |
| Branches | List Branches, Create Branch, Get Branch, Delete Branch | Branch lifecycle |
| Projects | List, Create, Get, Update, Delete Project | Workspace project lifecycle |
| Dependency | Notes |
|---|---|
Atlassian Bitbucket Cloud:latest Integration Model | Import from atlassian_bitbucket_cloud-latest.json before importing the project |
Atlassian Bitbucket Cloud integration instance | Create in Admin > Integrations with the connection properties above. Workflows are wired to an integration instance named Atlassian Bitbucket Cloud — update the adapter_id value in each workflow task if yours is named differently |