> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

> Bitbucket te ayuda a alojar código, revisar cambios y hacer seguimiento del trabajo en repositorios, ramas, solicitudes de extracción e incidencias mediante tu cuenta conectada.

# Bitbucket

Usa Bitbucket cuando tu flujo de trabajo necesite datos de repositorios, ramas, solicitudes de extracción o incidencias. Puede leer y actualizar el trabajo de revisión de código y seguimiento en tu espacio de trabajo conectado.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta de Bitbucket conectada que se usará para este paso. |
| Action | Yes | La acción de Bitbucket que se va a realizar (por ejemplo Get repository, List repositories, Create repository, List branches). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para usos avanzados. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Bitbucket en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay una conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Arguments form

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Common actions

| Action | Description |
| - | - |
| **Get repository** | Obtener detalles de un repositorio en un espacio de trabajo. |
| **List repositories** | Listar los repositorios disponibles en un espacio de trabajo. |
| **Create repository** | Crear un nuevo repositorio en un espacio de trabajo. |
| **List branches** | Listar las ramas de un repositorio. |
| **Get branch** | Obtener detalles de una rama específica. |
| **Create branch** | Crear una nueva rama a partir de un commit de destino. |
| **List commits** | Listar los commits de un repositorio. |
| **Get commit** | Obtener detalles de un commit específico. |
| **Get commit diff** | Obtener el diff de un commit o de un rango de revisiones. |
| **List pull requests** | Listar las solicitudes de extracción en un repositorio. |
| **Get pull request** | Obtener detalles de una solicitud de extracción específica. |
| **Create pull request** | Crear una solicitud de extracción desde una rama de origen. |
| **Approve pull request** | Aprobar una solicitud de extracción como el usuario actual. |
| **Update pull request** | Actualizar el título, la descripción o los revisores de una solicitud de extracción. |
| **List issues** | Listar incidencias en un repositorio. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso almacena la respuesta de Bitbucket como la salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Abre **Integrations** y conecta Bitbucket si aún no lo has hecho.
2. Añade un paso de **Bitbucket** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get repository** en **Action**.
5. Completa los campos obligatorios. Usa **Insert Variable** para hacer referencia a la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga devuelta en **Output**.

## Use cases

### Open a review from a branch

1. List branches
2. Get branch
3. Create pull request
4. Approve pull request

### Track a new bug

1. List issues
2. Create issue
3. Update issue

### Inspect a code change

1. List commits
2. Get commit
3. Get commit diff
4. Get pull request

## Notes

* Este paso depende de una integración de Bitbucket conectada en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta Bitbucket pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar la marca de autorización de terceros.

## Using Bitbucket as an Agent Tool

También puedes añadir Bitbucket como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Bitbucket**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de Bitbucket cuando son relevantes para la conversación.

See also: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.