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

# Linear

> Configura un paso del flujo de trabajo que crea o consulta issues y equipos de Linear usando una cuenta de Linear conectada

# Linear

Usa **Linear** cuando quieras que un paso del flujo de trabajo cree issues, liste issues, actualice issues o recupere información de equipos desde un espacio de trabajo de Linear conectado.

## Configuración

| Opción              | Requerido | Descripción                                                                                                                                                                                                                             |
| ------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                | No        | Etiqueta del paso en el lienzo del flujo de trabajo.                                                                                                                                                                                    |
| Authentication      | Sí        | La cuenta de Linear conectada que se usará para este paso.                                                                                                                                                                              |
| Action              | Sí        | La acción de Linear a realizar (Create Issue, List Issues, Update Issue, List Teams).                                                                                                                                                   |
| Arguments           | Sí        | 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 inyectar valores `{{placeholder}}`. Hay disponible una pestaña **Raw JSON** para uso avanzado. |
| 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 Linear en **Integrations** para tu espacio de trabajo. Si no hay una conexión activa con Linear disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de Arguments

Cuando seleccionas una acción, la sección **Arguments** renderiza automáticamente un formulario basado en el esquema de entrada de la acción — no se requiere edición manual de JSON. Cada campo incluye:

* Una etiqueta y descripción tomadas del esquema de la acción.
* Un botón **Insert Variable** junto a la etiqueta que inyecta referencias como `{{step_1.output.id}}` en la posición del cursor.
* Retroalimentación de validación en línea si se deja vacío un campo obligatorio.

### Tipos de campo

| Tipo de campo                   | Cómo se renderiza                                                                                             | Insert Variable disponible                                      |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| Texto / número                  | Entrada simple.                                                                                               | Solo en Create Issue y Update Issue                             |
| Booleano                        | Interruptor (etiqueta a la izquierda, interruptor a la derecha).                                              | No                                                              |
| Team (`team_id`)                | Menú desplegable poblado desde tu espacio de trabajo de Linear conectado — selecciona tu equipo por nombre.   | No                                                              |
| Project (`project_id`)          | Menú desplegable poblado desde tu espacio de trabajo de Linear conectado — selecciona tu proyecto por nombre. | No                                                              |
| Issue (`issue_id`)              | Menú desplegable poblado desde tu espacio de trabajo de Linear conectado — selecciona un issue por título.    | No                                                              |
| Label IDs / arreglos de cadenas | Lista de entradas de texto. El botón **Add** aparece junto a la etiqueta del arreglo.                         | No (los elementos de arreglo no admiten inserción de variables) |

Todas las opciones del menú desplegable se obtienen en una sola solicitud cuando seleccionas una cuenta conectada, por lo que abrir el panel de configuración no desencadena múltiples llamadas a la API. Si la búsqueda falla para un campo específico, vuelve a una entrada de texto plano para que aún puedas ingresar un valor manualmente o usar una `{{variable}}`.

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

## Acciones

| Acción       | Descripción                                                           |
| ------------ | --------------------------------------------------------------------- |
| Create Issue | Crea un nuevo issue en un equipo especificado.                        |
| List Issues  | Busca o lista issues con filtros opcionales.                          |
| Update Issue | Modifica un issue existente por ID.                                   |
| List Teams   | Lista todos los equipos en el espacio de trabajo de Linear conectado. |

## Salida

Este paso almacena la respuesta de la API de Linear como 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}}
```

Por ejemplo, después de un paso **Create Issue** podrías referenciar el ID del nuevo issue:

```text theme={null}
{{step_3.output.id}}
```

## Ejemplo

1. Abre **Integrations** y conecta Linear si aún no lo has hecho.
2. Agrega un paso **Linear** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Create Issue** en **Action**.
5. En el formulario **Arguments**, usa el menú desplegable **Team** (poblado automáticamente desde tu cuenta de Linear) para seleccionar un equipo, completa **Title** y opcionalmente **Description**. Usa **Insert Variable** junto a la etiqueta de cualquier campo para referenciar la salida de un paso anterior — por ejemplo, `{{step_1.output}}` como título del issue.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y, a continuación, revisa la respuesta devuelta en **Output**.

{/* Add screenshot: Linear step output tab after a test run */}

## Notas

* Este paso depende de una integración de Linear conectada en tu espacio de trabajo.
* La pestaña **Raw JSON** en Arguments siempre está disponible si prefieres escribir JSON directamente.
* Los campos **Team**, **Project** e **Issue** muestran menús desplegables poblados desde tu espacio de trabajo de Linear conectado. Si no se cargan opciones, verifica que la integración esté activa en **Integrations**.
* La acción **Update Issue** proporciona un menú desplegable **Issue** para que puedas seleccionar un issue existente por título en lugar de ingresar un ID manualmente.

## Uso de Linear como herramienta de agente

También puedes agregar Linear como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Linear**. En el panel de configuración de la herramienta, elige la cuenta de Linear conectada que el agente debe usar. El agente creará, buscará y actualizará issues automáticamente durante las conversaciones cuando sea relevante.

Consulta también: [Integraciones](../../../workspace/integrations), [Creación y edición](../../creating-and-editing) y [Pruebas e iteración](../../testing-and-iteration)
