Bitbucket Cloud
Turn incidents and requests into Bitbucket Cloud work items, and keep status in step across your tools.
30 ways to read, 16 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Bitbucket Cloud, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create branch
branches.createApproval by rule - Publish code insight report
commit_reports.upsertApproval by rule - List code insight reports
commit_reports.listRead
Example flow
- Bitbucket Cloud · List code insight reports
commit_reports.listDone - Bitbucket Cloud · Create branch
branches.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Bitbucket Cloud.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Bitbucket Cloud
- Bitbucket Cloud's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a Atlassian test account before you go live.
For developers
Technical detail
Read and write Bitbucket Cloud projects, repositories, pull requests, comments, tasks, branches, tags, build statuses, Code Insights, pipelines and deployments.
Atlassian API docs- Source actions
- 30
- Destination actions
- 16
- Data types
- 25
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
branch restrictions1
- List branch restrictionsSource
Branch permissions and merge checks on the repository.
branches2
- Create branchDestinationProvider duplicate protectionApproval before production
Creates a branch pointing at a commit.
- List branchesSource
Open branches with their head commit, most recent first.
commit reports2
- List code insight reportsSource
Code Insights reports (tests, coverage, security, bugs) on a commit.
- Publish code insight reportDestinationProvider duplicate protectionApproval before production
Creates or replaces a Code Insights report on a commit, for example test or scan results.
commit statuses2
- List commit statusesSource
Build statuses reported against a commit.
- Report build statusDestinationProvider duplicate protectionApproval before production
Creates or overwrites the build status with this key on a commit.
commits2
- Get commitSource
One commit with message, author and parents.
- List commitsSource
Commits reachable from a branch (or all branches), newest first.
current user1
- Get current userSource
The Atlassian account the credential acts as.
default reviewers1
- List default reviewersSource
Users added to every new pull request in the repository.
deployments2
- Get deploymentSource
One deployment with environment, state and released commit.
- List deploymentsSource
Deployments to environments with state and released commit.
environments1
- List deployment environmentsSource
Deployment environments such as Test, Staging and Production.
pipeline steps1
- List pipeline stepsSource
Steps in a pipeline with state and timings.
pipeline variables1
- List repository variablesSource
Pipelines repository variables; secured values are never returned.
pipelines3
- Run pipelineDestinationNot retried automaticallyApproval before production
Runs the default or a custom pipeline for a branch, with optional variables.
- Get pipelineSource
One pipeline with state, result and build minutes.
- List pipelinesSource
Pipelines run in the repository, newest first.
projects4
- Create projectDestinationProvider duplicate protectionApproval before production
Creates a project in the workspace.
- Get projectSource
One project by key.
- List projectsSource
Projects in the workspace.
- Update projectDestinationProvider duplicate protectionApproval before production
Updates a project's name, description or privacy. The key is not changed.
pull request comments3
- Add pull request commentDestinationNot retried automaticallyApproval before production
Adds a general comment, a reply, or an inline comment on a file line.
- List pull request commentsSource
General and inline comments on a pull request.
- Update pull request commentDestinationProvider duplicate protectionApproval before production
Replaces the text of a pull request comment.
pull request commits1
- List pull request commitsSource
Commits the pull request would merge into the destination branch.
pull request diffstat1
- List pull request diffstatSource
Files a pull request changes, with the change type and lines added and removed per file.
pull request statuses1
- List pull request build statusesSource
Build statuses reported against the pull request's source commit.
pull request tasks3
- Create pull request taskDestinationNot retried automaticallyApproval before production
Adds a review task to a pull request, optionally attached to a comment.
- List pull request tasksSource
Review tasks on a pull request with resolution state.
- Update pull request taskDestinationProvider duplicate protectionApproval before production
Changes a review task's text, or resolves or reopens it.
pull requests4
- Create pull requestDestinationNot retried automaticallyApproval before production
Opens a pull request from a branch in this repository.
- Get pull requestSource
One pull request with reviewers and participant approvals.
- List pull requestsSourceIncremental
Pull requests in a repository ordered by last update; open only unless states are given.
- Update pull requestDestinationProvider duplicate protectionApproval before production
Updates title, description, destination, reviewers or draft state of an open pull request.
report annotations1
- Publish report annotationsDestinationNot retried automaticallyApproval before production
Adds up to 100 annotations (findings on files and lines) to a Code Insights report.
repositories4
- Create repositoryDestinationProvider duplicate protectionApproval before production
Creates a Git repository with this slug, optionally in a project.
- Get repositorySource
One repository with project, main branch and fork policy.
- List repositoriesSourceIncremental
Repositories in the workspace, most recently updated last.
- Update repositoryDestinationProvider duplicate protectionApproval before production
Updates description, privacy, project, language, fork policy or main branch. Does not rename.
tags2
- Create tagDestinationProvider duplicate protectionApproval before production
Creates an annotated tag on a commit, for example a release version.
- List tagsSource
Tags with their target commit, most recent first.
webhooks1
- List repository webhooksSource
Webhook subscriptions on the repository with their events.
workspace members1
- List workspace membersSource
Members of the workspace.
workspaces1
- List workspacesSource
Workspaces the credential can access, with administrator flag.
Access and limits
- Authentication
- Atlassian account email and API token, or an access token
- Plans and access
- All Bitbucket Cloud plans. Workspace and repository access tokens need a Premium plan. API tokens act as the Atlassian account and are limited by the scopes chosen at creation; app passwords stopped working on 9 June 2026.
- Test environment
- A free Bitbucket Cloud workspace works for testing.
- Rate limits
- Hourly per-user limits per resource type (for example 1,000 requests per hour for most repository data, higher with scaled limits on Standard and Premium); HTTP 429.
- Pagination
- Response next URL with pagelen up to 100 (50 for pull requests); pipelines page by number.
- Provider events
- Repository and workspace webhooks for push, pull request, build status and pipeline events. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- The Bitbucket issue tracker endpoints are no longer in the published Bitbucket Cloud API specification, so issues are not implemented.
- Merging, declining and approving pull requests, stopping pipelines, and deleting repositories, projects, branches, tags, comments, tasks or reports are intentionally not implemented.
- Workspace code search is not implemented because Atlassian deprecates that endpoint on 1 November 2026.
- Repository and project updates use Bitbucket's PUT, which creates the resource when the slug or key does not exist; Nexra does not send a name on repository updates, so repositories are never renamed.
- Pipeline variable values marked secured are never returned by Bitbucket; Nexra does not write pipeline variables.
- pull_request_diffstat.list follows Bitbucket's documented 302 to the repository diffstat for the pull request's commit range (same origin, one hop). The raw diff and patch endpoints are not implemented.
- Pull request updated-since filters use Bitbucket query language (BBQL) on updated_on.
- Pull request, comment, task, pipeline and annotation creates have no idempotency key; uncertain writes are not repeated automatically. Project, repository, branch and tag creates converge because Bitbucket rejects an existing key, slug or name.
Developer reference
- Create the Atlassian credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Bitbucket Cloud, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/bitbucket and the Connections API.