Bitbucket

bitbucket

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

Developer Tools Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (17)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create a branchBITBUCKET_CREATE_BRANCHAcción

Creates 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.

Parámetros de entrada

namestringObligatorio
The name for the new branch (e.g., 'feature/new-login', 'bugfix/issue-123'). Important: Do not include the 'refs/heads/' prefix.
repo_slugstringObligatorio
The slug or UUID of the repository where the branch will be created. This is usually the repository's name in URL-friendly format.
workspacestringObligatorio
The workspace ID or UUID that owns the repository. This can typically be found in the URL of your Bitbucket workspace.
target_hashstringObligatorio
The full commit hash (SHA1) from which the new branch will be created. This commit must exist in the repository.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create an issueBITBUCKET_CREATE_ISSUEAcción

Creates 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.

Parámetros de entrada

kindstring
Type of the issue (e.g., 'bug', 'enhancement', 'proposal', 'task').
titlestringObligatorio
Title for the new issue.
due_onstring
Due date for the issue in ISO 8601 format (e.g., 'YYYY-MM-DDTHH:mm:ssZ').
contentstringObligatorio
Detailed description for the new issue.
assigneestring
Bitbucket username of the assignee. The assignee must have repository access.
prioritystring
Priority level of the issue (e.g., 'trivial', 'minor', 'major', 'critical', 'blocker').
repo_slugstringObligatorio
The slug of the Bitbucket repository.
workspacestringObligatorio
The ID or slug of the Bitbucket workspace.
version_idinteger
Numeric ID of an existing version to associate with this issue.
component_idinteger
Numeric ID of an existing component to associate with this issue.
milestone_idinteger
Numeric ID of an existing milestone to associate with this issue.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create an issue commentBITBUCKET_CREATE_ISSUE_COMMENTAcción

Adds a new comment with markdown support to an existing bitbucket issue.

Parámetros de entrada

contentstringObligatorio
The raw text content for the comment. This content supports markdown formatting, which Bitbucket will then render.
issue_idstringObligatorio
The unique identifier of the issue on which the comment will be posted.
repo_slugstringObligatorio
The slug (URL-friendly version) of the repository name.
workspacestringObligatorio
The ID or slug of the workspace or user that owns the repository.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a pull requestBITBUCKET_CREATE_PULL_REQUESTAcción

Creates a new pull request in a specified bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.

Parámetros de entrada

titlestringObligatorio
Concise title summarizing the changes for the pull request.
repo_slugstringObligatorio
Slug (URL-friendly name) of the repository for the pull request.
reviewersobject[]
List of Bitbucket user UUIDs to be added as reviewers.
workspacestringObligatorio
Workspace ID (UUID or slug) of the repository owner.
descriptionstring
Detailed Markdown description of the pull request, outlining changes and purpose.
source_branchstringObligatorio
Name of the source branch with changes to be merged.
destination_branchstring
Name of the destination branch for merging; defaults to repository's main branch if unspecified.
close_source_branchboolean
If true, automatically closes the source branch upon pull request merge.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create repositoryBITBUCKET_CREATE_REPOSITORYAcción

Creates a new bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project key` is not provided.

Parámetros de entrada

has_wikiboolean
Enable the wiki (`True`), or disable it (`False`).
languagestring
Primary programming language (e.g., 'python', 'java') for categorization.
repo_slugstringObligatorio
URL-friendly slug for the new repository.
workspacestringObligatorio
ID or slug of the Bitbucket workspace for the new repository.
has_issuesboolean
Enable the issue tracker (`True`), or disable it (`False`).
is_privateboolean
Repository visibility: `True` for private, `False` for public.
descriptionstring
Description for the new repository.
fork_policystringenum
Forking policy for the repository, determining who can create forks.
allow_forksno_public_forksno_forks
project_keystring
Key of the Bitbucket project for the repository; if omitted, it's placed in the workspace's oldest project.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create snippet commentBITBUCKET_CREATE_SNIPPET_COMMENTAcción

Posts a new top-level comment or a threaded reply to an existing comment on a specified bitbucket snippet.

Parámetros de entrada

contentstringObligatorio
Raw text content of the comment; Bitbucket will render any included markup (like Markdown).
parent_idinteger
ID of an existing comment to reply to, creating a threaded comment; if omitted, a top-level comment is created.
workspacestringObligatorio
Workspace ID or slug (e.g., 'my_workspace_slug' or a UUID) for the Bitbucket workspace containing the snippet.
encoded_idstringObligatorio
Unique, encoded ID of the Bitbucket snippet to comment on (typically part of the snippet's URL).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete issueBITBUCKET_DELETE_ISSUEAcción

Permanently deletes a specific issue, identified by its `issue id`, from the repository specified by `repo slug` within the given `workspace`.

Parámetros de entrada

issue_idstringObligatorio
The unique identifier of the issue to be deleted from the specified repository.
repo_slugstringObligatorio
The slug of the repository. This is the repository's name, usually in lowercase and with hyphens instead of spaces.
workspacestringObligatorio
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.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete repositoryBITBUCKET_DELETE_REPOSITORYAcción

Permanently deletes a specified bitbucket repository; this action is irreversible and does not affect forks.

Parámetros de entrada

repo_slugstringObligatorio
The slug (URL-friendly name) of the repository to be deleted. This identifies the repository within the workspace.
workspacestringObligatorio
The ID or slug of the Bitbucket workspace that owns the repository. This can be a user's username or a team's slug.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get current userBITBUCKET_GET_CURRENT_USERAcción

Retrieves the profile information (uuid, display name, links, creation date) for the currently authenticated bitbucket user.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get file from repositoryBITBUCKET_GET_FILE_FROM_REPOSITORYAcción

Retrieves 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.

Parámetros de entrada

pathstringObligatorio
Full path to the file within the repository (e.g., 'src/main.py').
commitstringObligatorio
Commit hash, branch name (fetches latest), or tag for the file version.
repo_slugstringObligatorio
Repository slug or UUID (typically URL-formatted name).
workspacestringObligatorio
Workspace ID or UUID (often username or team name) containing the repository.

Parámetros de salida

datastringObligatorio
The textual content of the retrieved file.
pathstringObligatorio
The full path of the file as it exists in the repository, confirming the retrieved file's location.
sizeintegerObligatorio
The size of the retrieved file in bytes.
errorstring
Error if any occurred during the execution of the action
commitstringObligatorio
The specific commit hash, branch, or tag from which the file was retrieved.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Pull RequestBITBUCKET_GET_PULL_REQUESTAcción

Get a single pull request by id with complete details.

Parámetros de entrada

repo_slugstringObligatorio
Repository slug (URL-friendly name).
workspacestringObligatorio
Workspace ID or slug (URL-friendly name).
pull_request_idintegerObligatorio
The ID of the pull request to retrieve.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get snippetBITBUCKET_GET_SNIPPETAcción

Retrieves a specific bitbucket snippet by its encoded id from an existing workspace, returning its metadata and file structure.

Parámetros de entrada

workspacestringObligatorio
The workspace ID (slug) or the workspace UUID surrounded by curly braces, identifying the Bitbucket workspace.
encoded_idstringObligatorio
The unique identifier (encoded ID) of the snippet to be retrieved.
accept_formatstring
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.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List pull requestsBITBUCKET_LIST_PULL_REQUESTSAcción

Lists pull requests in a specified, accessible bitbucket repository, optionally filtering by state (open, merged, declined).

Parámetros de entrada

pageinteger
Page number for paginated results (starts from 1).
statestringenum
Lifecycle state of a pull request.
OPENMERGEDDECLINED
pageleninteger
Number of pull requests per page (1-100). Bitbucket default if not specified.
repo_slugstringObligatorio
Repository slug (URL-friendly name).
workspacestringObligatorio
Workspace ID or slug (URL-friendly name).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List repositories in workspaceBITBUCKET_LIST_REPOSITORIES_IN_WORKSPACEAcción

Lists repositories in a specified bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.

Parámetros de entrada

qstring
Query string using Bitbucket's REST API filtering syntax to filter repositories. For detailed syntax, refer to Bitbucket API documentation.
rolestring
Filters repositories by the authenticated user's role within each repository.
sortstring
Field for sorting repository results. Prefix with '-' for descending order. Common sortable fields: 'name', 'updated_on', 'created_on'.
workspacestringObligatorio
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}').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List workspace membersBITBUCKET_LIST_WORKSPACE_MEMBERSAcción

Lists all members of a specified bitbucket workspace; the workspace must exist.

Parámetros de entrada

workspacestringObligatorio
The workspace ID (UUID) or slug from which to list members. The slug is the user-friendly, URL-safe identifier for the workspace.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List workspacesBITBUCKET_LIST_WORKSPACESAcción

Lists bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.

Parámetros de entrada

qstring
Query string to filter workspaces by attributes, following Bitbucket's filtering syntax.
sortstring
Field to sort returned workspaces by; prefix with a hyphen (-) for descending order.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update an issueBITBUCKET_UPDATE_ISSUEAcción

Updates an existing issue in a bitbucket repository by modifying specified attributes; requires `workspace`, `repo slug`, `issue id`, and at least one attribute to update.

Parámetros de entrada

kindstring
The updated kind (type) for the issue. If omitted, kind remains unchanged.
statestring
The updated state for the issue. If omitted, state remains unchanged.
titlestring
The new title for the issue. If omitted, the title remains unchanged.
contentstring
The new content or description for the issue, in raw text format. If omitted, the content remains unchanged.
versionstring
The name of the version affected by this issue (e.g., '1.0.0', '2.0-beta'). If omitted, the version remains unchanged.
issue_idstringObligatorio
The unique identifier (ID) of the issue to be updated.
prioritystring
The updated priority for the issue. If omitted, priority remains unchanged.
componentstring
The name of the component to associate with the issue (e.g., 'API', 'Frontend'). If omitted, the component remains unchanged.
milestonestring
The name of the milestone to associate with the issue (e.g., 'Sprint 1', 'v1.0 Launch'). If omitted, the milestone remains unchanged.
repo_slugstringObligatorio
The slug or name of the repository (e.g., 'my-app-repo').
workspacestringObligatorio
The workspace ID or slug that owns the repository (e.g., 'my-company' or '{123e4567-e89b-12d3-a456-426614174000}').
assignee_account_idstring
The Bitbucket account ID (UUID) of the user to assign the issue to. If omitted, the assignee remains unchanged.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not