bb_list_branches
List branches in a Bitbucket repository, filter by query, sort by criteria, and paginate results. Returns branch details including name, latest commit, and merge strategy. Requires workspace and repository slugs.
Instructions
Lists branches in a repository identified by workspaceSlug
and repoSlug
. Filters branches by an optional text query
and supports custom sort
order. Provides pagination via limit
and cursor
. Pagination details are included at the end of the text content. Returns branch details as Markdown with each branch's name, latest commit, and default merge strategy. Requires Bitbucket credentials.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
cursor | No | Pagination cursor for retrieving the next set of results. Obtained from previous response when more results are available. | |
limit | No | Maximum number of items to return (1-100). Controls the response size. Defaults to 25 if omitted. | |
query | No | Query string to filter branches by name or other properties (text search). | |
repoSlug | Yes | Repository slug to list branches from. Must be a valid repository slug in the specified workspace. Example: "project-api" | |
sort | No | Field to sort branches by. Common values: "name" (default), "-name", "target.date". Prefix with "-" for descending order. | |
workspaceSlug | No | Workspace slug containing the repository. If not provided, the system will use your default workspace. Example: "myteam" |