Bitbucket

Manage Bitbucket Cloud repositories, pull requests, and pipelines via the Bitbucket Cloud REST API.

Base URL: https://api.bitbucket.org/2.0
Auth: HTTP Basic — your Atlassian account email + a Bitbucket API token.

Operations

API Token Setup

1. Log in to Bitbucket Cloud.
2. Go to Personal settings (avatar menu) → Personal Bitbucket settings → API tokens.
3. Click Create token, give it a name, and select the scopes you need:
4. Repositories: Read — for list-repos, get-repo
5. Pull requests: Read — for list-prs
6. Pull requests: Write — for create-pr
7. Pipelines: Read — for list-pipelines
8. Pipelines: Write — for trigger-pipeline
9. Copy the token — it is shown only once.
10. In InTouch, use your Atlassian account email as username and the token as apiKey.

Input Parameters

Examples

List repos in a workspace

[
  {
    "name": "list_repos",
    "type": "bitbucket",
    "input": {
      "username": "[email protected]",
      "apiKey": "{{credential.bitbucket_token}}",
      "operation": "list-repos",
      "workspace": "my-team"
    }
  }
]

Open a pull request

[
  {
    "name": "open_pr",
    "type": "bitbucket",
    "input": {
      "username": "[email protected]",
      "apiKey": "{{credential.bitbucket_token}}",
      "operation": "create-pr",
      "workspace": "my-team",
      "repoSlug": "my-service",
      "title": "feat: add retry logic",
      "sourceBranch": "feature/retry",
      "destBranch": "main",
      "description": "Adds exponential backoff to the HTTP client."
    }
  }
]

Trigger a pipeline

[
  {
    "name": "run_pipeline",
    "type": "bitbucket",
    "input": {
      "username": "[email protected]",
      "apiKey": "{{credential.bitbucket_token}}",
      "operation": "trigger-pipeline",
      "workspace": "my-team",
      "repoSlug": "my-service",
      "pipelineBranch": "main"
    }
  }
]

Output

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• ok
• operation
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.