Bitbucket

Developer tools Atlassian email and API token

Read repositories, manage pull requests and issues, and run pipelines on Bitbucket Cloud from any Windmill script, flow or app.

Set up in 3 steps

Create an API token

At id.atlassian.com/manage-profile/security/api-tokens, choose Create API token with scopes and pick Bitbucket. Tick only the scopes your scripts need, and copy the token — it is shown only once.

Add the resource in Windmill

Open Resources, add a resource of type bitbucket. username is your Atlassian account email and password is the API token.

Run your first script

Fork any script below and read a repository before writing anything.

Scripts

Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.

Submit a script →

Trigger flows from Bitbucket

Bitbucket is not only a destination. These inbound paths are supported today.

New pull requests, issues, commits and more (scheduled poll)

Seven trigger scripts (New Pull Request, New Issue, New Commit, New Commit Comment, New Branch, New Pipeline Event, New Repository) each return what appeared since their last run. In a flow, add a trigger, choose Scheduled Poll, and pick the script and an interval. The steps after it run once per new item, and each flow keeps its own cursor.

Resource type

The shape of the credential every script on this page expects.

bitbucket

View raw schema →

Field	Type	Required	What it is
password	string	Yes	An Atlassian API token with Bitbucket scopes, from https://id.atlassian.com/manage-profile/security/api-tokens.
username	string	Yes	Your Atlassian account email.

Questions

My app password stopped working

Atlassian retired Bitbucket app passwords in favour of API tokens. Create an API token and put your Atlassian account email in username — your Bitbucket username does not work with API tokens on the REST API.

Can I use my account password?

No. The REST API rejects account passwords. Use an API token, which you can scope and revoke without touching your account.

Is my API token stored on the hub?

Never. It lives only in your own Windmill workspace, encrypted at rest.

Set up in 3 steps

Create an API token

Add the resource in Windmill

Run your first script

Scripts

Update a task on a pull request

Create a task on a pull request

Delete a task on a pull request

List tasks on a pull request

Get a task on a pull request

List pull requests

Create a commit by uploading a file

Run a pipeline

Get file or directory contents

Update a snippet

Create a snippet

Get a snippet

List a pull request activity log

Get a tag

Check if current user is watching a issue

Create a comment on an issue

Update an explicit user permission for a repository

Delete a report

Get log file for a step

Update the branching model config for a project

Get a pull request

Check if the current user is watching a snippet

List explicit user permissions for a repository

Delete a download artifact

Get a known host

Delete a SSH key

Get a webhook for a repository

Delete an explicit user permission for a repository

List commits on a pull request

Get the diff stat for a pull request

Trigger flows from Bitbucket

New pull requests, issues, commits and more (scheduled poll)

Resource type

bitbucket

Questions