- Integrations
- /
- Bitbucket
- /
- Actions
- /
- List Branches
ActionBitbucketUpdated May 2026
What branches exist in this Bitbucket repo?
Short answer: Drop the "Bitbucket → List Branches" action anywhere in your workflow, map the inputs from upstream nodes, and publish.
Inputs
The fields this action accepts.
Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.
| Field | Type | Required | Description |
|---|---|---|---|
Workspace workspace | string | Required | Workspace. Example: my-team |
Repository Slug repo_slug | string | Required | Repository Slug. Example: my-project |
Query Filter q | string | Optional | Bitbucket query filter expression |
Sort sort | string | Optional | Field to sort by (prefix with - for descending) |
Page Size pagelen | string | Optional | Page Size. e.g. "25" |
Sample request
{"workspace": "e.g. my-team","repo_slug": "e.g. my-project","q": "e.g. name ~ \"feature\"","sort": "e.g. -target.date","pagelen": "25"}
Returns
{"size": 5,"values": [{"name": "main","links": {"html": {"href": "https://bitbucket.org/my-team/my-project/branch/main"}},"target": {"date": "2025-01-15T12:00:00+00:00","hash": "abc123def456"}}]}
Use these fields in downstream nodes for routing, logging, or error handling.
Triggered by
Apps that pair well as the trigger for List Branches.
Any of these apps can fire this action as part of a workflow.
FAQ
Questions about List Branches.
What does the List Branches action do in Bitbucket?
Returns the repository's branches with last commit info. Useful for "find branches that haven't been touched in 90+ days for cleanup" maintenance workflows.
What inputs does List Branches require?
Required: Workspace, Repository Slug. Every input accepts a static value or a variable from any upstream node in your workflow.
Can I use dynamic inputs from earlier workflow nodes?
Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.
What happens if Bitbucket returns an error?
The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.
Does List Branches support batch operations?
Yes. Run List Branches inside a Loop node to process arrays. Tiny Command handles Bitbucket's rate limits automatically so you don't have to throttle manually.
More actions
Other Bitbucket actions.
Action
Add PR Comment
Posts a comment on a pull request. Useful for AI-driven code-review bots, for cross-tool notifications ("Linear issue X closed → comment on the linked PR"), or for automated linting/style feedback.
ActionCreate Issue
Files a new issue in a Bitbucket repository with title, content, kind (bug/enhancement/task), priority, assignee. For "Sentry error → file a Bitbucket issue" or "support ticket marked as bug → file repo issue" workflows.
ActionCreate Pull Request
Opens a new PR from source branch to destination branch with title, description, and reviewers. Useful for automation that auto-creates PRs from generated branches (e.g., dependabot-style auto-update workflows).
ActionGet Pull Request
Returns the PR by ID with all metadata — branches, reviewers, status, merge conflicts, build status. The standard lookup for cross-tool sync workflows that need current PR state.
ActionGet Repository
Returns the repository with name, description, language, visibility, fork info, recent activity. Useful for "show me all repos this team owns" inventory workflows or for validating a repo exists before downstream operations.
ActionList Commits
Paginated commits with optional branch and author filters. For "weekly digest of commits by contributor" reporting workflows or for "what shipped in the last release" changelog-generation patterns.
Send list branches from your workflows.
Triggered by anything in the catalog. Free tier available. No credit card.