Bitbucket is a Git-based code hosting and collaboration platform supporting private and public repositories, enabling teams to manage and review code through pull requests and integrations
Bitbucket is a Git-based code hosting and collaboration platform supporting private and public repositories, enabling teams to manage and review code through pull requests and integrations On Nagent, Bitbucket is exposed as a fully-configurable developer tools integration that any agent can call — 107 actions, and OAuth authentication. No code is required to wire Bitbucket into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Bitbucket to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Bitbucket into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Bitbucket, with input parameters and output schema. Drop these into any step of an agent built in Helix.
BITBUCKET_APPROVE_PULL_REQUESTTool to approve a pull request as the authenticated user. Use when you need to formally approve changes in a pull request review process.
Input parameters
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
The ID of the pull request to approve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_BROWSE_REPOSITORY_PATHTool to retrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository. Use when you need flexible access to repository content - returns raw file data for files or paginated directory listings for directories.
Input parameters
Filter query string using Bitbucket's REST API filtering syntax to narrow results. Only applicable when browsing directories.
Page number for paginated results (starts from 1). Only applicable when browsing directories.
File or directory path within the repository to browse. Use empty string for root directory.
Field name for sorting results. Prefix with '-' for descending order. Only applicable when browsing directories.
Commit hash, branch name, or tag to browse from. Defaults to 'master' if not specified.
Response format. Use 'meta' to return metadata as JSON instead of raw file contents when browsing a file.
Number of entries per page (1-100). Only applicable when browsing directories. Controls pagination size.
Maximum depth for breadth-first recursive directory traversal. Only applicable when path is a directory. Large values may cause timeouts.
Repository slug or UUID (typically URL-formatted name).
Workspace ID or UUID (often username or team name) containing the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_BRANCHCreates a new branch in a Bitbucket repository from a target commit hash; the branch name must be unique, adhere to Bitbucket's naming conventions, and not include the 'refs/heads/' prefix.
Input parameters
The name for the new branch (e.g., 'feature/new-login', 'bugfix/issue-123'). Important: Do not include the 'refs/heads/' prefix.
The slug or UUID of the repository where the branch will be created. This is usually the repository's name in URL-friendly format.
The workspace ID or UUID that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
The full commit hash (SHA1) from which the new branch will be created. This commit must exist in the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_ISSUECreates a new issue in a Bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component IDs exist.
Input parameters
Type of the issue (e.g., 'bug', 'enhancement', 'proposal', 'task').
Title for the new issue.
Due date for the issue in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:mm:ssZ').
Detailed description for the new issue.
Bitbucket username of the assignee. The assignee must have repository access.
Priority level of the issue (e.g., 'trivial', 'minor', 'major', 'critical', 'blocker').
The slug of the Bitbucket repository.
The ID or slug of the Bitbucket workspace.
Numeric ID of an existing version to associate with this issue.
Numeric ID of an existing component to associate with this issue.
Numeric ID of an existing milestone to associate with this issue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_ISSUE_COMMENTAdds a new comment with markdown support to an existing Bitbucket issue.
Input parameters
The raw text content for the comment. This content supports markdown formatting, which Bitbucket will then render.
The unique identifier of the issue on which the comment will be posted.
The slug (URL-friendly version) of the repository name.
The ID or slug of the workspace or user that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_PULL_REQUESTCreates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.
Input parameters
Concise title summarizing the changes for the pull request.
Slug (URL-friendly name) of the repository for the pull request.
List of Bitbucket user UUIDs to be added as reviewers. Malformed or non-existent UUIDs trigger validation errors.
Workspace ID (UUID or slug) of the repository owner.
Detailed Markdown description of the pull request, outlining changes and purpose.
Name of the source branch with changes to be merged.
Name of the destination branch for merging; defaults to repository's main branch if unspecified.
If true, automatically closes the source branch upon pull request merge.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_PULL_REQUEST_COMMENTCreates a new comment on a Bitbucket pull request. Supports top-level comments, threaded replies, and inline code comments. Use when providing feedback on a PR, replying to existing comments, or commenting on specific code lines.
Input parameters
Location details for inline code comments.
The slug (URL-friendly version) of the repository name.
The ID or slug of the workspace that owns the repository.
The raw text content for the comment. Supports markdown formatting which Bitbucket will render.
The unique identifier of the pull request to comment on.
ID of an existing comment to reply to, creating a threaded comment. If omitted, creates a top-level comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONSAdds multiple annotations to a commit report in bulk. Use when you need to add code analysis findings (vulnerabilities, code smells, bugs) to a report attached to a specific commit.
Input parameters
The commit hash to which the report belongs. This is the full SHA-1 commit identifier.
The unique identifier of the report to which annotations will be added.
The repository slug (URL-friendly name) that contains the commit.
The workspace ID or slug that owns the repository. This can be a user's username or a team's slug.
Array of annotation objects to be added to the report. Each annotation must have path, line, summary, and severity.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_REPOSITORIES_COMMITS2Tool to list commits from a revision using POST method. Identical to GET endpoint but allows sending include/exclude parameters in request body to avoid URL length limits. Use when include/exclude parameters are too long for query strings.
Input parameters
Page number for paginated results (starts from 1).
Optional file path to filter commits. Only commits that modified this file or directory will be returned.
Optional commit hash or branch to exclude from the results. Can be used to create a range with the 'include' parameter. Use POST method when this value is very long.
Optional commit hash or branch to include in the results. Can be used to create a range with the 'exclude' parameter. Use POST method when this value is very long.
Number of commits per page (1-100). Bitbucket default is typically 30 if not specified.
The commit hash, branch name, tag, or other revision identifier to start listing commits from. Commits are returned in reverse chronological order starting from this revision.
The slug of the repository. This is the repository's name, usually in lowercase and with hyphens instead of spaces.
The workspace ID (slug) or UUID of the Bitbucket workspace that owns the repository. This can be the workspace name or its universally unique identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_REPOSITORYCreates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided.
Input parameters
Enable the wiki (`True`), or disable it (`False`).
Primary programming language (e.g., 'python', 'java') for categorization.
URL-friendly slug for the new repository.
Workspace identifier. Can be a slug (e.g., 'my-workspace') or UUID with curly braces (e.g., '{uuid}'). Bare UUIDs without braces are automatically normalized to the required format.
Enable the issue tracker (`True`), or disable it (`False`).
Repository visibility: `True` for private, `False` for public.
Description for the new repository.
Forking policy for the repository, determining who can create forks.
Key of the Bitbucket project for the repository; if omitted, it's placed in the workspace's oldest project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_SNIPPET_COMMENTPosts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.
Input parameters
Raw text content of the comment; Bitbucket will render any included markup (like Markdown).
ID of an existing comment to reply to, creating a threaded comment; if omitted, a top-level comment is created.
Workspace ID or slug (e.g., 'my_workspace_slug' or a UUID) for the Bitbucket workspace containing the snippet.
Unique, encoded ID of the Bitbucket snippet to comment on (typically part of the snippet's URL).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_TEAMS_PIPELINES_CONFIG_VARIABLESCreates a team-level pipeline configuration variable in Bitbucket. Use when you need to add environment variables or configuration values that should be available to all pipelines within a team.
Input parameters
The name/key of the pipeline variable. Must be unique within the team's pipeline configuration.
The value of the pipeline variable. This will be available to all pipelines in the team.
Whether the variable should be secured (masked in logs). Set to `True` for sensitive values like passwords or API keys, `False` for non-sensitive values.
The team username that owns the pipeline configuration. This is the team identifier in Bitbucket.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_CREATE_USERS_PIPELINES_CONFIG_VARIABLESCreates a user-level pipeline variable for Bitbucket pipelines. Use when you need to create account-level configuration variables that can be used across all repositories owned by the user.
Input parameters
The name/key of the pipeline variable. Must be unique for the user.
The value of the pipeline variable.
Whether the variable should be secured/encrypted (true) or stored as plain text (false). Defaults to false.
The username or UUID of the user. Can be a username (e.g., 'myusername') or a UUID enclosed in curly braces (e.g., '{4f3ecac3-c951-41d4-8a4c-95f40be978fc}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_DELETE_COMMIT_COMMENTPermanently deletes a specific comment on a commit. Use when removing outdated, incorrect, or unwanted feedback on a commit.
Input parameters
The commit hash (SHA) or commit reference. This identifies the commit that has the comment to be deleted.
The slug of the repository. This is the repository's name, usually in lowercase and with hyphens instead of spaces.
The workspace ID (slug) or UUID of the Bitbucket workspace that owns the repository. This can be the workspace name or its universally unique identifier.
The unique identifier of the comment to be deleted from the specified commit.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_DELETE_ISSUEPermanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.
Input parameters
The unique identifier of the issue to be deleted from the specified repository.
The slug of the repository. This is the repository's name, usually in lowercase and with hyphens instead of spaces.
The workspace ID (slug) or UUID of the Bitbucket workspace that owns the repository. This can be the workspace name or its universally unique identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_DELETE_PULL_REQUEST_COMMENTPermanently deletes a specific pull request comment (top-level, inline, or threaded reply). Use when removing outdated, incorrect, or unwanted feedback from a pull request.
Input parameters
The slug of the repository. This is the repository's name, usually in lowercase and with hyphens instead of spaces.
The workspace ID (slug) or UUID of the Bitbucket workspace that owns the repository. This can be the workspace name or its universally unique identifier.
The unique identifier of the comment to be deleted from the pull request. This can be a top-level comment, inline comment, or threaded reply.
The unique identifier of the pull request containing the comment to be deleted.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_DELETE_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONSDeletes a single annotation matching the provided ID from a commit report. Use when you need to remove a specific annotation from a code analysis report.
Input parameters
The commit hash to which the report belongs. This is the full SHA-1 commit identifier.
The unique identifier of the report that contains the annotation.
The repository slug (URL-friendly name) that contains the commit.
The workspace ID or slug that owns the repository. This can be a user's username or a team's slug.
The unique identifier of the annotation to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_DELETE_REPOSITORYPermanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.
Input parameters
The slug (URL-friendly name) of the repository to be deleted. This identifies the repository within the workspace.
The ID or slug of the Bitbucket workspace that owns the repository. This can be a user's username or a team's slug.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_DELETE_SNIPPETS_WATCHStops watching a specific snippet. Use when you want to unsubscribe from notifications for a snippet.
Input parameters
The workspace ID (slug) or the workspace UUID surrounded by curly braces, identifying the Bitbucket workspace.
The unique identifier (encoded ID) of the snippet to stop watching.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_DELETE_USER_PIPELINE_VARIABLEPermanently deletes a user-level pipeline configuration variable identified by its UUID. Use this to remove pipeline variables that are no longer needed at the account level.
Input parameters
The username of the Bitbucket account that owns the pipeline variable. This is the account identifier.
The UUID of the pipeline variable to delete. This must be in UUID format (e.g., b070fa8a-c3db-42bd-870c-dea7c980c7b8) and can be optionally wrapped in curly braces.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_BRANCHRetrieves detailed information about a specific branch in a Bitbucket repository. Use when you need to get branch metadata, the commit it points to, or verify a branch exists.
Input parameters
The name of the branch to retrieve (e.g., 'master', 'main', 'feature/my-feature'). Do not include the 'refs/heads/' prefix.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_COMMIT_BUILD_STATUSGet a specific build status for a commit in Bitbucket. Use when you need to check the status of a particular build/CI run for a commit.
Input parameters
The unique key identifying the specific build status.
The commit hash to get the build status for.
The slug or UUID of the repository.
The workspace ID or slug that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_COMMIT_CHANGESTool to retrieve a page of changes made in a specified commit, showing all changed files with their change statistics (lines added/removed, status). Use when you need to enumerate files modified in a specific commit or commit range.
Input parameters
Page number for paginated results (starts from 1).
Commit SHA or range (e.g., '3a8b42' for single commit or '3a8b42..9ff173' for range).
Number of changes per page (1-100). Bitbucket default is 500 if not specified.
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_COMMIT_COMMENTRetrieves a specific comment from a commit by its ID. Use when you need to fetch details of a particular commit comment including content, author, timestamps, and inline location.
Input parameters
The commit hash to retrieve the comment from.
The repository slug (URL-friendly name).
The workspace slug or UUID that owns the repository.
The unique identifier for the comment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_COMMIT_DIFFTool to retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository. Use when you need to see the actual code changes in a commit or between two commits. Supports filtering by file path and various diff options.
Input parameters
Optional file path to filter the diff to a specific file or directory. If omitted, returns diff for all changes.
A commit SHA, branch name, tag, or revspec (e.g. '3a8b42..9ff173' for range). For a single commit, provide the commit hash. For comparing two commits, use 'commit1..commit2' format.
Whether to generate merge diff. Set to true for merge commit diffs.
Whether to generate a 2-way three-dot diff when spec contains two commits. Set to true to use three-dot diff notation.
Whether to include binary file diffs. Set to true to include binary diffs in the output.
Number of context lines to include around changes. If not specified, uses the default context lines.
Whether to detect file renames. Set to true to show rename detection in the diff.
The repository slug (URL-friendly name).
The workspace ID or username that owns the repository.
Whether to ignore whitespace changes in the diff. Set to true to exclude whitespace-only changes.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_CURRENT_USER2Tool to retrieve complete profile information for the currently authenticated Bitbucket user. Use when you need comprehensive user details including account_id, username, nickname, and other profile fields.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_DEPLOYMENT_ENVIRONMENT_VARIABLESRetrieves deployment environment level variables for a specific Bitbucket repository environment. Use when you need to view or audit environment-specific configuration variables for deployments.
Input parameters
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
The UUID of the deployment environment. Must be provided with curly braces (e.g., {2e1c3c19-12f2-4e9b-9ed7-45512af9a7ce}). The API will handle URL-encoding automatically.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_FILE_FROM_REPOSITORYRetrieves a specific file's content from a Bitbucket repository at a given commit (hash, branch, or tag), failing if the file path is invalid for that commit.
Input parameters
Full path to the file within the repository (e.g., 'src/main.py').
Commit hash, branch name (fetches latest), or tag for the file version.
Repository slug or UUID (typically URL-formatted name).
Workspace ID or UUID (often username or team name) containing the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_HOOK_EVENTSRetrieves a paginated list of all valid webhook events for a specified entity type (repository or workspace). Use when you need to discover available webhook event types for subscription or webhook configuration.
Input parameters
The type of entity for which to retrieve available webhook events. Use 'repository' for repository-level events or 'workspace' for workspace-level events. Note: team and user webhooks are deprecated; use workspace instead.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_OPENID_CONFIGURATIONRetrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC. Use when integrating Bitbucket Pipelines with resource servers (AWS, GCP, Vault) using OpenID Connect authentication. Returns issuer URL, JWKS URI, and supported capabilities.
Input parameters
The workspace identifier (workspace slug or UUID). This identifies the Bitbucket workspace for which to retrieve the OIDC configuration.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_PULL_REQUESTGet a single pull request by ID with complete details.
Input parameters
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name). Must exactly match the pull request's workspace (case-sensitive); slug and UUID are not interchangeable.
The ID of the pull request to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_PULL_REQUEST_COMMENTTool to retrieve a specific comment from a pull request by its ID. Use when you need to fetch details of a particular pull request comment including content, author, timestamps, and inline location.
Input parameters
The repository slug (URL-friendly name).
The workspace slug or UUID that owns the repository.
The unique identifier for the comment.
The unique identifier of the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_PULL_REQUEST_COMMITSTool to retrieve commits for a specified pull request. Use when reviewing the commit history of a PR or analyzing changes included in a pull request.
Input parameters
Number of commits per page (1-100).
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
The ID of the pull request to retrieve commits for.
Level of detail in the response. 'minimal' (default) returns only essential commit information (hash, message, date, author name/email, html_link). 'full' returns the complete Bitbucket API response with all nested objects.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_PULL_REQUEST_DIFFTool to fetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff). Use when reviewing code changes in a PR. Supports optional truncation for large diffs via max_chars parameter.
Input parameters
Maximum number of characters to return in the diff. If the diff exceeds this limit, it will be truncated. If None, no truncation is applied. Use this to protect against very large diffs.
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
The ID of the pull request to retrieve the diff for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_PULL_REQUEST_DIFFSTATTool to get the diffstat for a Bitbucket pull request, showing all changed files with their change statistics (lines added/removed, status). Use when you need to enumerate files modified in a PR.
Input parameters
Page number for paginated results (starts from 1).
Number of diffstat entries per page (1-100). Bitbucket default is 500 if not specified.
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
The ID of the pull request to get diffstat for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_RAW_FILE_CONTENTDEPRECATED: Use BITBUCKET_GET_FILE_FROM_REPOSITORY instead. Tool to retrieve the raw content of a file from a Bitbucket repository at a specified commit, branch, or tag. Use when you need to read file contents from a specific revision.
Input parameters
The file path including filename and extension (e.g., 'src/main.py' or 'README.md').
The commit SHA, branch name, or tag name to retrieve the file from.
The repository slug (URL-friendly name) where the file is located.
The workspace ID or username that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_BRANCHING_MODELReturn the branching model as applied to the repository. Use when you need to understand the repository's branch workflow configuration, including development/production branches and branch type prefixes.
Input parameters
The repository slug.
This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_COMMITTool to retrieve detailed information about a specific commit in a Bitbucket repository. Use when you need to get complete commit details including author, message, date, parents, and related links.
Input parameters
The commit hash (SHA) to retrieve.
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_COMMIT_COMMENTSRetrieves all comments on a specific commit in a Bitbucket repository. Returns both global and inline code comments. Use when you need to view feedback, discussions, or notes left on a specific commit.
Input parameters
Page number for pagination. Defaults to 1 if not specified.
The commit hash/SHA to retrieve comments for.
Number of items per page for pagination. Defaults to 10 if not specified.
The slug (URL-friendly version) of the repository name.
The ID or slug of the workspace that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_COMMIT_REPORTReturns a single report matching the provided ID from a commit. Use when you need to retrieve details of a specific analysis report (e.g., security scan, code coverage, test results, or bug report) for a commit.
Input parameters
The commit hash to which the report belongs. This is the full SHA-1 commit identifier.
The repository slug (URL-friendly name) that contains the commit.
Either the uuid or external-id of the report to retrieve.
The workspace ID or slug that owns the repository. This can be a user's username or a team's slug.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_COMMIT_REPORTSTool to get reports linked to a specific commit. Use when you need to retrieve analysis results, test reports, security scans, or code coverage data associated with a commit.
Input parameters
The commit hash to retrieve reports for.
The repository slug (URL-friendly name).
The workspace ID or slug that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONSReturns a single annotation matching the provided ID from a commit report. Use when you need to retrieve details of a specific code analysis finding (e.g., vulnerability, code smell, or bug) identified in a commit.
Input parameters
The commit hash to which the report belongs. This is the full SHA-1 commit identifier.
Either the uuid or external-id of the report that contains the annotation.
The repository slug (URL-friendly name) that contains the commit.
The workspace ID or slug that owns the repository. This can be a user's username or a team's slug.
Either the uuid or external-id of the annotation to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_COMMIT_STATUSESReturns all build statuses (e.g., CI/CD pipeline results) for a specific commit. Use when you need to check build status, verify test results, or monitor deployment pipelines for a particular commit.
Input parameters
The commit hash (SHA) to retrieve statuses for. Can be full or abbreviated hash.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_EFFECTIVE_BRANCHING_MODELRetrieves the effective branching model for a Bitbucket repository, showing which branching model is currently applied (including any inheritance from project-level settings). Use when you need to understand the repository's branch workflow configuration, including development and production branches and branch type prefixes.
Input parameters
The repository slug. This is usually the repository's name in URL-friendly format.
The workspace slug or UUID that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_ENVIRONMENTS2Retrieve detailed information about a specific deployment environment in a Bitbucket repository. Use when you need to get environment configuration, deployment settings, or check environment properties like locks and restrictions.
Input parameters
The slug or UUID of the repository.
The workspace ID or slug that owns the repository.
The UUID of the environment to retrieve. Must include curly braces (e.g., {2e1c3c19-12f2-4e9b-9ed7-45512af9a7ce}).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_FILEHISTORYReturns a paginated list of commits that modified the specified file. Use when you need to track file changes over time, find who modified a file, or determine when a file was created or last changed.
Input parameters
Query string for filtering commits in the file history. Common use: filter by commit date using 'commit.date<=YYYY-MM-DD' or 'commit.date>=YYYY-MM-DD'. Example: 'commit.date<=2024-12-31' returns only commits before that date.
Page number for paginated results (starts from 1).
Full path to the file within the repository (e.g., 'README.md', 'src/main.py').
Commit hash, branch name, or tag from which to retrieve file history. The API returns commits reachable from this reference that modified the file.
Comma-separated list of fields to include or exclude from the response. Prefix with '+' to add fields or '-' to remove them. Example: '+values.commit.message' adds commit messages to the response.
Number of commits per page (1-100). Default is typically 30 if not specified.
Whether to follow file renames through history. If true (default), returns commits that modified the file even if it had a different name. If false, only returns commits where the file had the current path.
The repository slug (URL-friendly name) or UUID.
The workspace slug or UUID that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_ISSUES_VOTETool to check whether the authenticated user has voted for a specific issue in a Bitbucket repository. Use when you need to verify if the current user has already voted on an issue before attempting to vote or unvote.
Input parameters
The numeric ID of the issue to check vote status for.
The slug (URL-friendly name) of the repository.
The workspace ID or slug (URL-friendly name) that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_MERGE_BASEGet the merge base (best common ancestor) between two commits in a Bitbucket repository. Use when you need to find the common ancestor commit between two branches or commits for comparison or merge operations.
Input parameters
Two commit hashes separated by '..' (e.g., '3a8b42..9ff173' or 'abc123..def456'). This specifies the two commits to find the best common ancestor between.
The slug or UUID of the repository.
The workspace ID or slug that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PIPELINES2Retrieve a specified pipeline from a Bitbucket repository. Use when you need to get detailed information about a specific pipeline execution including its status, build number, and results.
Input parameters
The repository slug (URL-friendly name) or UUID.
The workspace ID (slug) or workspace UUID that owns the repository.
The pipeline UUID to retrieve. Must be in UUID format, typically enclosed in curly braces.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_CACHESRetrieves the repository pipelines caches. Use when you need to list all caches configured for Bitbucket Pipelines in a specific repository.
Input parameters
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_RUNNERSRetrieves the list of self-hosted runners configured for a repository's pipelines. Use when you need to view available runners for pipeline execution.
Input parameters
The repository slug (URL-friendly identifier) for the repository.
The workspace slug or UUID that owns the repository. This can be the workspace slug (e.g., 'my-workspace') or its UUID enclosed in curly braces (e.g., '{workspace-uuid}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_SCHEDULESRetrieves configured pipeline schedules for a Bitbucket repository. Use when you need to view scheduled pipeline runs and their cron patterns.
Input parameters
The slug or identifier of the repository.
The workspace ID or slug that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_SSH_KNOWN_HOSTSRetrieves repository-level SSH known hosts configured for Bitbucket Pipelines. Use when you need to list or verify SSH known hosts that Pipelines can connect to during builds.
Input parameters
The repository slug (URL-friendly identifier) for the repository.
The workspace slug or UUID. This identifies the Bitbucket workspace that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PIPELINES_CONFIG_VARIABLESRetrieves repository-level pipeline variables for a specific Bitbucket repository. Use when you need to view or audit pipeline configuration variables that are scoped to a repository.
Input parameters
Query string for filtering results using Bitbucket Query Language (BBQL).
Page number for pagination. Use this to retrieve subsequent pages of results.
Field to sort results by. Prefix with a hyphen (-) for descending order.
Number of items to return per page. Controls the size of the paginated response.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PIPELINES_STEPSRetrieves all steps for a given pipeline. Use when you need to inspect the individual steps of a pipeline execution, including their state, duration, and commands.
Input parameters
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
The UUID of the pipeline. Must be enclosed in curly braces (e.g., '{f5500ca2-b74d-4e6a-84bf-5d2f73695152}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PULLREQUESTS_ACTIVITYGet paginated activity log for all pull requests in a repository. Returns comments, updates, approvals, and request changes. Use when you need to track pull request activity history.
Input parameters
Page number for paginated results (starts from 1).
Number of activity entries per page (1-50). Bitbucket default is 20 if not specified.
The repository slug (URL-friendly name).
The workspace ID or slug (URL-friendly name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PULLREQUESTS_COMMENTSRetrieves a paginated list of comments on a specific pull request in a Bitbucket repository. Returns global, inline, and threaded comments. Use when you need to view feedback, discussions, or reviews left on a pull request.
Input parameters
Page number for pagination. Defaults to 1 if not specified.
Sort order for results. Default is oldest to newest. Use '-created_on' for newest to oldest.
Number of items per page for pagination. Defaults to 10 if not specified.
The slug (URL-friendly version) of the repository name.
The ID or slug of the workspace that owns the repository.
The pull request ID to retrieve comments for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_PULLREQUESTS_STATUSESReturns all build statuses (e.g., CI/CD pipeline results) for a specific pull request. Use when you need to check build status, verify test results, or monitor deployment pipelines for a pull request.
Input parameters
Page number for paginated results (starts from 1).
Number of statuses per page (1-100). Bitbucket default is 30 if not specified.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
The ID of the pull request to retrieve statuses for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_REFSReturns the branches and tags in the repository. Use when you need to list all refs (both branches and tags) in a single API call with optional filtering by type, name pattern, or commit hash.
Input parameters
Query string using Bitbucket Query Language (BBQL) to filter refs. Syntax: 'field operator value'. Operators: '=' (exact match), '~' (contains substring), '!=' (not equal). String values MUST be enclosed in double quotes. Filter by name pattern using 'name~"pattern"', by type using 'type="branch"' or 'type="tag"', or by commit hash using 'target.hash="hash"'. Examples: 'name~"feature/"' (refs starting with feature/), 'type="branch"' (only branches), 'type="tag"' (only tags), 'target.hash="a1b2c3d4"' (refs pointing to specific commit). Combine multiple conditions with AND/OR (e.g., 'type="branch" AND name~"feature/"').
Page number for paginated results (starts from 1).
Field for sorting ref results. Prefix with '-' for descending order. Common sortable fields: 'name', 'target.date' (commit date). Default sorting applies natural sorting for ref names with numeric values.
Number of refs per page (1-100). Bitbucket default is typically 10 if not specified.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_REFS_TAGSRetrieves detailed information about a specific tag in a Bitbucket repository. Use when you need to get tag metadata, target commit details, or verify a tag exists.
Input parameters
The name of the tag to retrieve (without refs/tags/ prefix). For example, 'v1.0.0' or 'fedex17'.
The slug (URL-friendly name) of the repository. This identifies the repository within the workspace.
The workspace ID or slug that owns the repository. This can be a user's username or a team's slug.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_SRCLists the contents of the root directory on the repository's main branch without needing to specify a commit or branch. This endpoint redirects to the main branch automatically.
Input parameters
Optional format parameter. Use 'meta' to get metadata instead of raw contents when accessing files.
The repository slug (URL-friendly repository name).
The workspace ID or slug that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORIES_WATCHERSRetrieves a paginated list of all the watchers on the specified repository. Use when you need to see who is watching a particular repository.
Input parameters
The repository slug (URL-friendly identifier) for the repository.
The workspace ID or slug that owns the repository. This is the user-friendly identifier or UUID for the workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORYRetrieves detailed information about a specific repository in a Bitbucket workspace. Use when you need to get repository metadata, settings, or details.
Input parameters
The repository slug (URL-friendly identifier) for the repository to retrieve.
The workspace slug or UUID. This identifies the Bitbucket workspace that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_REPOSITORY_PATCHTool to retrieve the git patch content for a Bitbucket repository at a specified revision or commit range. Use when you need to review code changes, generate diffs, or analyze modifications between commits. Returns raw patch in unified diff format.
Input parameters
A commit hash, branch name, tag, or commit range (e.g., '3a8b42..9ff173'). If a single commit is provided, the diff is against its first parent. For ranges, shows diff between the two commits.
Maximum number of characters to return in the patch. If the patch exceeds this limit, it will be truncated. If None, no truncation is applied. Use this to protect against very large patches.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_SNIPPETRetrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.
Input parameters
The workspace ID (slug) or the workspace UUID surrounded by curly braces, identifying the Bitbucket workspace.
The unique identifier (encoded ID) of the snippet to be retrieved.
The desired format for the response. Valid options are 'application/json', 'multipart/related', or 'multipart/form-data'. This may affect how snippet content or file data is presented.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_SNIPPETS_WATCHChecks if the current user is watching a specific snippet. Use when you need to verify watch status for a snippet.
Input parameters
The workspace ID (slug) or the workspace UUID surrounded by curly braces, identifying the Bitbucket workspace.
The unique identifier (encoded ID) of the snippet to check watch status for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_SSH_LATEST_KEYSRetrieves a paginated list of SSH keys for a specified Bitbucket user. Use when you need to view or audit SSH keys configured for a user account.
Input parameters
The page number for pagination. Starts at 1.
Number of SSH keys to return per page. Default is typically 10.
The username of the Bitbucket user to retrieve SSH keys for. This is the account username (slug), not the display name or UUID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_USERRetrieves public profile information for a specific Bitbucket user by username or UUID. Use when you need to get user details like display name, avatar, creation date, and links to related resources.
Input parameters
The username or UUID of the user to retrieve. Can be a username (e.g., 'john_doe') or a UUID enclosed in curly braces (e.g., '{4f3ecac3-c951-41d4-8a4c-95f40be978fc}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_USER_EMAILSReturns all the authenticated user's email addresses, both confirmed and unconfirmed. Use when you need to retrieve all email addresses associated with the current user's account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_USER_EMAILS2Retrieves details about a specific email address for the authenticated user. Use when you need to check if an email is primary, confirmed, or verify email ownership.
Input parameters
The email address to retrieve details for. Must be one of the authenticated user's email addresses.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_USER_PERMISSIONS_REPOSITORIESReturns an object for each repository the caller has explicit access to, including their permission level. Use when you need to discover which repositories the authenticated user can access and their specific permissions.
Input parameters
Page number for paginated results. Used to retrieve a specific page in a multi-page result set. Page numbers start at 1.
Number of items to return per page for pagination. Controls the size of the paginated result set. Default is typically 10 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_USER_PERMISSIONS_WORKSPACESRetrieves workspace memberships and permission levels for the authenticated user. Returns an object for each workspace the caller is a member of, along with their effective role (highest privilege level). Use when you need to determine which workspaces a user can access and their permission level in each.
Input parameters
Query string to filter results by workspace slug or permission level using Bitbucket's filtering syntax. Examples: q=workspace.slug="workspace1" or q=permission="owner". Supported fields: workspace.slug (workspace identifier), permission (permission level). Use exact match with = operator. String values must be enclosed in double quotes.
Page number for pagination. Use this to navigate through multiple pages of results.
Number of items per page for pagination. Controls how many workspace permission objects are returned in a single response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_USER_WORKSPACESTool to retrieve all workspaces accessible to the authenticated user. Use when you need to list workspaces the current user can access, optionally filtered by workspace slug or permission level.
Input parameters
Query string to filter workspaces by attributes such as workspace slug or permission level. Examples: 'workspace.slug="my-workspace"' or 'permission="owner"'. Follow Bitbucket's filtering syntax for complex queries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_WORKSPACERetrieves detailed information about a specific Bitbucket workspace. Use when you need to get workspace metadata, settings, or details.
Input parameters
The workspace ID (slug) or workspace UUID surrounded by curly-braces. Example: 'my-workspace' or '{workspace-uuid}'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_WORKSPACES_PULLREQUESTSTool to get all workspace pull requests authored by a specified user. Use when you need to retrieve pull requests created by a specific user across all repositories in a workspace.
Input parameters
Page number for paginated results (starts from 1).
Lifecycle state of a pull request.
Number of pull requests per page (1-100). Bitbucket default is 10 if not specified.
Workspace ID or slug (URL-friendly name).
The username of the user whose pull requests you want to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_GET_WORKSPACES_SEARCH_CODETool to search for code in the repositories of the specified workspace. Use when you need to find specific code patterns, function definitions, or text across all repositories in a workspace.
Input parameters
Page number for pagination. Use this to navigate through multiple pages of search results.
Additional fields to include in the response, using the fields parameter syntax. For example, '+values.file.commit.repository' to include repository details for each code match.
Number of results per page. Controls how many code search results are returned in a single response.
The workspace identifier. This can be the workspace slug (e.g., 'my-workspace') or its UUID enclosed in curly braces (e.g., '{workspace-uuid}').
The search query string to search for in the code. Can use advanced syntax like 'foo+repo:demo' to search within specific repositories, or 'test+ext:py' to filter by file extension.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_BRANCHESLists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting. Use when you need to discover available branches, search for specific branch patterns, or navigate repository branch structure.
Input parameters
Query string using Bitbucket Query Language (BBQL) to filter branches. Syntax: 'field operator value'. Operators: '=' (exact match), '~' (contains substring), '!=' (not equal). String values MUST be enclosed in double quotes. Common use case: filter by branch name pattern using 'name~"pattern"'. Examples: 'name~"feature/"' (branches starting with feature/), 'name="main"' (exact match for main branch). Combine multiple conditions with AND/OR (e.g., 'name~"feature/" OR name~"bugfix/"').
Page number for paginated results (starts from 1).
Field for sorting branch results. Prefix with '-' for descending order. Common sortable fields: 'name', 'target.date' (commit date). Default sorting applies natural sorting for branch names with numeric values.
Number of branches per page (1-100). Bitbucket default is typically 10 if not specified.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_COMMITSTool to retrieve a page of commits from a Bitbucket repository. Returns commits in reverse chronological order (newest first), similar to git log. Use when you need to browse commit history, filter commits by branch/tag, or restrict to commits affecting a specific path.
Input parameters
Page number for paginated results (starts from 1).
Filter commits to only those that affect the specified file or directory path.
Branch or tag name, or commit SHA to exclude from the commit history. Commits reachable from this ref will be excluded. Multiple values can be separated by commas.
Branch or tag name, or commit SHA to include in the commit history. If not specified, the repository's default branch is used. Multiple values can be separated by commas (e.g., 'main,develop').
Number of commits per page (1-100). Bitbucket default is typically 30 if not specified.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_COMMITS_FROM_REVISIONTool to list commits starting from a specific revision in a Bitbucket repository. Commits are paginated and returned in reverse chronological order. Use when you need to retrieve commit history from a specific commit, branch, or tag.
Input parameters
Page number for paginated results (starts from 1).
Optional file path to filter commits. Only commits that modified this file or directory will be returned.
Optional commit hash or branch to exclude from the results. Can be used to create a range with the 'include' parameter.
Optional commit hash or branch to include in the results. Can be used to create a range with the 'exclude' parameter.
Number of commits per page (1-100). Bitbucket default is typically 30 if not specified.
The commit hash, branch name, tag, or other revision identifier to start listing commits from. Commits are returned in reverse chronological order starting from this revision.
The slug of the repository. This is the repository's name, usually in lowercase and with hyphens instead of spaces.
The workspace ID (slug) or UUID of the Bitbucket workspace that owns the repository. This can be the workspace name or its universally unique identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_COMMITS_ON_MASTERLists commits on the master branch of a Bitbucket repository. Use when you need to retrieve the commit history for the master branch, including commit messages, authors, dates, and parent relationships.
Input parameters
Page number for paginated results (starts from 1).
Number of commits per page (1-100). Bitbucket default is typically 30 if not specified.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_DEPLOYMENTSLists deployments for a specified Bitbucket repository. Use when you need to view deployment history and status across environments.
Input parameters
Query string for filtering deployment results using Bitbucket Query Language (BBQL). Use operators like '=' for exact match, '~' for contains, '!=' for not equal.
Page number of the results to retrieve. Defaults to 1 if not specified.
Field designation for sorting results. Prefix with '-' for descending order.
Number of results per page (1-100). Defaults to the Bitbucket API's default page length if not specified.
The repository slug (URL-friendly name).
The workspace ID or slug (URL-friendly name). This can be the workspace slug (e.g., 'my-workspace') or its UUID enclosed in curly braces (e.g., '{workspace-uuid}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_ISSUESLists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee. Use when you need to discover issue IDs or get an overview of repository issues.
Input parameters
Filter issues by kind (type). Use 'bug', 'enhancement', 'proposal', or 'task'. If not provided, issues of all kinds are returned.
Page number for paginated results (starts from 1).
Filter issues by state. Use a specific state like 'new', 'open', 'resolved', 'on hold', 'invalid', 'duplicate', 'wontfix', or 'closed'. If not provided, all issues regardless of state are returned.
Number of issues per page (1-100). Bitbucket default is 10 if not specified.
Filter issues by assignee. Provide the Bitbucket account ID (UUID) of the assignee. Use 'null' (as a string) to find unassigned issues. If not provided, issues with any assignee (or no assignee) are returned.
Filter issues by priority. Use 'trivial', 'minor', 'major', 'critical', or 'blocker'. If not provided, issues of all priorities are returned.
The slug (URL-friendly name) of the repository.
The workspace ID or slug (URL-friendly name) that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_PIPELINESTool to find pipelines in a Bitbucket repository. Returns pipeline metadata including state, trigger, and duration. Use when you need to browse pipeline history or check pipeline status.
Input parameters
Page number for paginated results (starts from 1).
Number of pipelines per page (1-100). Bitbucket default is typically 10 if not specified.
The repository slug (URL-friendly identifier).
The workspace slug or UUID that owns the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_PULL_REQUESTSLists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).
Input parameters
Page number for paginated results (starts from 1).
Lifecycle state of a pull request.
Number of pull requests per page (1-50). Bitbucket default is 10 if not specified.
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_PULL_REQUEST_TASKSLists all tasks associated with a pull request in a Bitbucket repository. Use when you need to view or track tasks on a PR.
Input parameters
Page number for paginated results (starts from 1).
Number of tasks per page (1-100). Bitbucket default is 10 if not specified.
The slug (URL-friendly name) of the repository.
The workspace ID or slug (URL-friendly name) that owns the repository.
The unique identifier of the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_REPOSITORIESRetrieves a paginated list of all public repositories on Bitbucket. Use when you need to discover or search across public repositories, optionally filtered by role, query string, creation date, or sorted by various fields.
Input parameters
Query string using Bitbucket Query Language (BBQL) to filter repositories. Note: This parameter requires the 'role' parameter to be specified. Syntax: 'field operator value'. Operators: '=' (exact match), '~' (contains substring), '!=' (not equal), '>' '>=' '<' '<=' (comparison for dates/numbers). String values MUST be enclosed in double quotes. Valid repository fields: 'name', 'full_name', 'is_private', 'created_on', 'updated_on', 'language'. Combine multiple conditions with AND/OR (e.g., 'name~"api" AND is_private=false').
The page number to retrieve in the paginated list of results. Page numbering starts at 1. Use together with 'pagelen' to control pagination.
Enum for repository role filter values.
Field to sort returned repositories by. Prefix with a hyphen (-) for descending order. Common sortable fields: 'name', 'created_on', 'updated_on'.
ISO-8601 timestamp to filter results created after this date/time. Format: YYYY-MM-DDTHH:mm:ss.sssZ (e.g., '2024-01-01T00:00:00.000Z'). Only repositories created after this timestamp will be returned.
The number of items to return per page. Accepts values between 1 and 100 (inclusive). Defaults to 10 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_REPOSITORIES_ENVIRONMENTSList all deployment environments configured for a Bitbucket repository. Use when you need to view available environments for deployments, check environment configurations, or select an environment for deployment operations.
Input parameters
Query string for filtering environment results using Bitbucket Query Language (BBQL). Use operators like '=' for exact match, '~' for contains, '!=' for not equal.
Page number of the results to retrieve. Defaults to 1 if not specified.
Field designation for sorting results. Prefix with '-' for descending order.
Number of results per page (1-100). Defaults to the Bitbucket API's default page length if not specified.
The repository slug (URL-friendly name) or UUID.
The workspace ID or slug that owns the repository. This can be the workspace slug (e.g., 'my-workspace') or its UUID enclosed in curly braces (e.g., '{workspace-uuid}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACELists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results. Responses are paginated; iterate using the `next` field in each response until it is absent to retrieve all repositories.
Input parameters
Query string using Bitbucket Query Language (BBQL) to filter repositories. Syntax: 'field operator value'. Operators: '=' (exact match), '~' (contains substring), '!=' (not equal), '>' '>=' '<' '<=' (comparison for dates/numbers). String values MUST be enclosed in double quotes. Valid repository fields: 'name', 'full_name', 'project.key', 'is_private', 'created_on', 'updated_on', 'language'. Combine multiple conditions with AND/OR (e.g., 'name~"api" AND is_private=true'). Note: 'repository' is NOT a valid field name - use 'name' instead. Invalid or malformed expressions return empty results silently rather than an error.
Page number of the results to retrieve. Defaults to 1 if not specified.
Filters repositories by the authenticated user's role within each repository.
Field for sorting repository results. Prefix with '-' for descending order. Common sortable fields: 'name', 'updated_on', 'created_on'.
Number of results per page (1-100). Defaults to 10 if not specified.
The identifier of the Bitbucket workspace. This can be the workspace slug (e.g., 'my-workspace') or its UUID enclosed in curly braces (e.g., '{workspace-uuid}'). Empty results may indicate insufficient permissions rather than an invalid identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_REPOSITORY_PATHSLists file and directory entries under a repository path at a given revision, with optional breadth-first recursion via max_depth for repository traversal and scanning. Fails if the path points to a file rather than a directory.
Input parameters
Filter query string using Bitbucket's REST API filtering syntax to narrow results.
Page number for paginated results (starts from 1).
Directory path within the repository to list. Use empty string for root. Must be a directory, not a file.
Field name for sorting results. Prefix with '-' for descending order.
Commit hash, branch name, or tag to list paths from. Determines the revision to traverse.
Number of entries per page (1-100). Controls pagination size.
Maximum depth for breadth-first recursive directory traversal. If specified, includes nested subdirectories up to this depth.
Repository slug or UUID (typically URL-formatted name).
Workspace ID or UUID (often username or team name) containing the repository.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_SNIPPETSReturns all snippets accessible to the authenticated user. Use when you need to discover or list snippets, optionally filtered by role (owner, contributor, or member).
Input parameters
Page number of the results to retrieve. Defaults to 1 if not specified.
Enum for snippet role filter values.
Number of results per page (1-100). Defaults to the Bitbucket API's default page length if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_TAGSLists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting. Use when you need to discover available tags, search for specific tag patterns, or find tags pointing to specific commits.
Input parameters
Query string using Bitbucket Query Language (BBQL) to filter tags. Syntax: 'field operator value'. Operators: '=' (exact match), '~' (contains substring), '!=' (not equal). String values MUST be enclosed in double quotes. Common use case: filter by tag name pattern using 'name~"pattern"' or by commit hash using 'target.hash="hash"'. Examples: 'name~"v1."' (tags starting with v1.), 'name="v1.0.0"' (exact match for v1.0.0 tag), 'target.hash="a1b2c3d4"' (tags pointing to specific commit). Combine multiple conditions with AND/OR (e.g., 'name~"v1." OR name~"v2."').
Page number for paginated results (starts from 1).
Field for sorting tag results. Prefix with '-' for descending order. Common sortable fields: 'name', 'target.date' (commit date). Default sorting applies natural sorting for tag names with numeric values.
Number of tags per page (1-100). Bitbucket default is typically 10 if not specified.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_VERSIONSLists versions (milestones) in a Bitbucket repository's issue tracker. Use when you need to discover available versions for associating with issues, or to retrieve version IDs for use with create_issue.
Input parameters
Query string using Bitbucket Query Language (BBQL) to filter versions. Syntax: 'field operator value'. Operators: '=' (exact match), '~' (contains substring), '!=' (not equal). String values MUST be enclosed in double quotes. Common use case: filter by version name pattern using 'name~"pattern"'. Examples: 'name~"1."' (versions starting with 1.), 'name="2.0"' (exact match for version 2.0).
Page number for paginated results (starts from 1).
Field for sorting version results. Prefix with '-' for descending order. Common sortable fields: 'name'. Default sorting applies natural sorting.
Number of versions per page (1-100). Bitbucket default is typically 10 if not specified.
The slug or UUID of the repository. This is usually the repository's name in URL-friendly format.
The workspace ID or slug that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_WORKSPACE_MEMBERSLists all members of a specified Bitbucket workspace; the workspace must exist.
Input parameters
Page number of the results to retrieve. Defaults to 1 if not specified.
Number of results per page (1-100). Defaults to the Bitbucket API's default page length if not specified.
The workspace ID (UUID) or slug from which to list members. The slug is the user-friendly, URL-safe identifier for the workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_WORKSPACE_PROJECTSLists projects in a specified Bitbucket workspace. Use when you need to retrieve all projects belonging to a workspace.
Input parameters
Query string to filter projects by attributes, following Bitbucket's filtering syntax. Syntax: 'field operator value'. Operators: '=' (exact match), '~' (contains substring), '!=' (not equal). String values MUST be enclosed in double quotes. Valid project fields: 'name', 'key', 'is_private'. Combine multiple conditions with AND/OR (e.g., 'name~"api" AND is_private=true').
Specifies which page of results to return. Page numbering starts at 1.
Field to sort returned projects by; prefix with a hyphen (-) for descending order. Common sortable fields: 'name', 'key', 'created_on', 'updated_on'.
Controls the number of items per page. Must be between 1 and 100.
The identifier of the Bitbucket workspace. This can be the workspace slug (e.g., 'my-workspace') or its UUID enclosed in curly braces (e.g., '{workspace-uuid}').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_LIST_WORKSPACESLists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted. Results are paginated; follow the `next` field in each response to retrieve subsequent pages until `next` is absent. When multiple workspaces are returned, verify the correct `slug` or UUID before passing to downstream tools.
Input parameters
Query string to filter workspaces by attributes, following Bitbucket's filtering syntax.
Page number of the results to retrieve. Defaults to 1 if not specified.
Field to sort returned workspaces by; prefix with a hyphen (-) for descending order.
Number of results per page (1-100). Defaults to 10 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_MERGE_PULL_REQUESTTool to merge a Bitbucket Cloud pull request via the REST API. Use when you need to complete a PR merge after approval and checks pass. Supports custom merge messages, merge strategies, and source branch deletion.
Input parameters
Custom merge commit message. If not provided, Bitbucket generates a default message.
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
Merge strategy to use. Common values include 'merge_commit', 'squash', 'fast_forward'. If not specified, uses the repository's default merge strategy.
The ID of the pull request to merge.
Whether to close the source branch after merging. If not specified, uses the repository's default setting.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_REQUEST_PULL_REQUEST_CHANGESTool to request changes on a pull request as the authenticated user. Use when you need to formally request changes in a pull request review process, indicating the PR needs modifications before approval.
Input parameters
Repository slug (URL-friendly name).
Workspace ID or slug (URL-friendly name).
The ID of the pull request to request changes on.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_RESOLVE_PULL_REQUEST_COMMENTTool to resolve or reopen a pull request comment thread. Use when marking a comment as addressed during review or reopening a previously resolved thread.
Input parameters
Action to perform: 'resolve' marks the comment thread as addressed, 'reopen' unmarks it.
The repository slug (URL-friendly name).
The workspace slug or UUID that owns the repository.
The unique identifier for the comment to resolve or reopen.
The unique identifier of the pull request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_SEARCH_TEAM_CODESearch for code in repositories of a specified team. Matches can occur in file content or paths. Note: Teams endpoints were deprecated in Oct 2020; use workspace search endpoints for new integrations.
Input parameters
Which page of search results to retrieve (starts from 1).
How many search results to retrieve per page (1-100). Default is 10 if not specified.
The team account username or UUID in curly braces (e.g., 'team-name' or '{team-uuid}'). Note: Teams endpoints are deprecated since Oct 2020; consider using workspace endpoints instead.
The search query string. Supports advanced syntax like 'repo:demo' to filter by repository, or combine terms with AND/OR operators. Same syntax as the Bitbucket UI search.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_SEARCH_USER_REPOSITORIES_CODETool to search for code in the repositories of a specified user. Use when you need to find specific code patterns, functions, or text across all repositories owned by a user.
Input parameters
Which page of search results to retrieve (default: 1).
Request additional fields in the response. Use '+' prefix to expand nested fields (e.g., '+values.file.commit.repository' to include repository details).
How many search results per page (default: 10).
The search query using the same syntax as the Bitbucket UI. Can include repo filters (e.g., 'test', 'foo+repo:demo').
The username of the user whose repositories to search.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_UPDATE_INSIGHTS_PROJECTS_REPOS_COMMITS_REPORTSCreate or update an insight report for a commit. Creates a new report if it doesn't exist, or replaces the existing one if a report already exists for the given repository, commit, and report key. Note: replacing an existing report will be rejected if the authenticated user was not the creator of the specified report.
Input parameters
Array of data items containing additional information about the report. Maximum 6 items.
An external link providing more information about the report. Must be a valid HTTP/HTTPS URL.
The title of the report. Maximum 450 characters.
The commit hash to which the report belongs. This is the full SHA-1 commit identifier (40 characters).
Enum for report results.
Detailed description of the report. Maximum 2000 characters. Supports escaped newlines.
URL to the logo image for the reporting tool. Must be a valid HTTP/HTTPS URL.
Unique identifier for the report. Recommend using reverse DNS namespacing (e.g., 'com.company.tool.report-name').
The name of the system or tool that created the report. Maximum 450 characters.
The repository slug (URL-friendly name) that contains the commit.
The workspace ID or slug that owns the repository. This can be a user's username or a team's slug.
The type of report: SECURITY, COVERAGE, TEST, or BUG.
Whether remote link is enabled for the report.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_UPDATE_ISSUEUpdates an existing issue in a Bitbucket repository by modifying specified attributes; requires `workspace`, `repo_slug`, `issue_id`, and at least one attribute to update.
Input parameters
Types/kinds of Bitbucket issues.
States for Bitbucket issues.
The new title for the issue. If omitted, the title remains unchanged.
The new content or description for the issue, in raw text format. If omitted, the content remains unchanged.
The name of the version affected by this issue (e.g., '1.0.0', '2.0-beta'). If omitted, the version remains unchanged.
The unique identifier (ID) of the issue to be updated.
Priority levels for Bitbucket issues.
The name of the component to associate with the issue (e.g., 'API', 'Frontend'). If omitted, the component remains unchanged.
The name of the milestone to associate with the issue (e.g., 'Sprint 1', 'v1.0 Launch'). If omitted, the milestone remains unchanged.
The slug or name of the repository (e.g., 'my-app-repo').
The workspace ID or slug that owns the repository (e.g., 'my-company' or '{123e4567-e89b-12d3-a456-426614174000}').
The Bitbucket account ID (UUID) of the user to assign the issue to. If omitted, the assignee remains unchanged.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_UPDATE_PULL_REQUESTTool to update an existing pull request's editable fields (e.g., title, description, reviewers) via the Bitbucket Cloud API. Use when you need to modify a pull request without creating a new one. Only sends fields that are explicitly provided to avoid accidental overwrites.
Input parameters
If true, marks the pull request as a draft. If false, marks it as ready for review. If omitted, draft status remains unchanged.
Updated title for the pull request. If omitted, title remains unchanged.
Repository slug (URL-friendly name) or UUID.
Updated list of Bitbucket user UUIDs to be reviewers. Replaces existing reviewers. If omitted, reviewers remain unchanged.
Workspace ID (slug) or workspace UUID that owns the repository.
Updated Markdown description for the pull request. If omitted, description remains unchanged.
Unique ID of the pull request to update.
If true, automatically closes the source branch upon pull request merge. If omitted, setting remains unchanged.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_UPDATE_REPOSITORIES_COMMIT_COMMENTSUpdates the contents of a comment on a commit. Use when you need to modify an existing comment's text on a commit.
Input parameters
The commit hash to update the comment on.
The repository slug (URL-friendly name).
The workspace slug or UUID that owns the repository.
The unique identifier for the comment to update.
The updated raw text content for the comment. Supports markdown formatting.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_UPDATE_REPOSITORIES_COMMIT_REPORTS_ANNOTATIONSCreates or updates an individual annotation for a commit report. Use when you need to add or modify code analysis findings (vulnerabilities, code smells, or bugs) identified in a commit.
Input parameters
Line number in the file where the finding occurs. Must be a positive integer.
URL providing more information about the finding, such as documentation or issue tracker link.
File path where the annotation applies, relative to the repository root.
The commit hash to which the report belongs. This is the full SHA-1 commit identifier.
Enumeration of annotation result statuses.
Extended description providing additional context, remediation guidance, or technical details about the finding.
Brief description of the finding. Should concisely explain what was detected.
Impact level of the finding. CRITICAL for severe issues requiring immediate attention, HIGH for important issues, MEDIUM for moderate concerns, LOW for minor issues.
The repository slug (URL-friendly name) that contains the commit.
Either the uuid or external-id of the report that will contain the annotation.
The workspace ID or slug that owns the repository. This can be a user's username or a team's slug.
Unique identifier for tracking this annotation in an external system. Useful for correlating with external tools.
Either the uuid or external-id of the annotation to create or update.
Type of annotation indicating the nature of the finding: VULNERABILITY for security issues, CODE_SMELL for maintainability issues, or BUG for functional defects.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_UPDATE_TEAMS_PIPELINES_CONFIG_VARIABLESUpdates a team-level pipeline configuration variable in Bitbucket. Use when you need to modify existing environment variables or configuration values that are available to all pipelines within a team.
Input parameters
The name/key of the pipeline variable. Must be unique within the team's pipeline configuration.
The updated value of the pipeline variable. This will be available to all pipelines in the team.
Whether the variable should be secured (masked in logs). Set to `True` for sensitive values like passwords or API keys, `False` for non-sensitive values.
The team username that owns the pipeline configuration. This is the team identifier in Bitbucket.
The UUID of the pipeline variable to update. This must be in UUID format (e.g., 252a372b-3e5d-4869-9df5-c379d6b062e9) and can be optionally wrapped in curly braces.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BITBUCKET_UPDATE_USERS_PIPELINES_CONFIG_VARIABLESUpdates a user-level pipeline variable for Bitbucket pipelines. Use when you need to modify account-level configuration variables such as changing the value, key name, or security status.
Input parameters
The updated name/key of the pipeline variable. If omitted, the key remains unchanged.
The updated value of the pipeline variable. If omitted, the value remains unchanged.
Whether the variable should be secured/encrypted (true) or stored as plain text (false). If omitted, the secured status remains unchanged.
The UUID or username of the user. When using UUID format, it should be URL-encoded (e.g., %7B4f3ecac3-c951-41d4-8a4c-95f40be978fc%7D for {4f3ecac3-c951-41d4-8a4c-95f40be978fc}).
The UUID of the pipeline variable to update. This can be obtained from the list or get variable endpoints.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 99 agents privately built on Nagent that already use Bitbucket.
Build on Nagent
Connect Bitbucket to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Bitbucket, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Bitbucket is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Bitbucket is connected, you configure its 107 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Bitbucket steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Bitbucket event fires, the agent kicks off automatically.
Every Bitbucket action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Bitbucket ships with 107 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Bitbucket together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Bitbucket-based workflows tailored to your business.