Abrir app

DocumentaciónWorkflowsHTTP y herramientas de desarrollo

Linear nodo

Crea, lista y actualiza issues de Linear directamente desde tu workflow, a través de la API GraphQL oficial de Linear (un solo endpoint para todo). Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.

8 min de lecturaActualizado el

Qué hace este nodo

Crea, lista y actualiza issues de Linear directamente desde tu workflow, a través de la API GraphQL oficial de Linear (un solo endpoint para todo).

Usa Linear como un paso claramente definido en un workflow de anymize.

  • Procesa 1 entrada.
  • Ofrece 1 salida para los pasos siguientes.
  • Se ejecuta como un paso normal del flujo.

Configurar el nodo

  1. 01Abre un workflow y añade Linear desde el catálogo de nodos.
  2. 02Completa los campos obligatorios y asigna valores de los pasos anteriores.
  3. 03Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
  4. 04Conecta la salida correcta y activa el workflow después de una prueba completa.

Acciones y modos

Elige la función necesaria en Acción. El panel mostrará los ajustes correspondientes.

  • Crear issue
  • Listar issues
  • Actualizar issue

Ajustes

CampoSignificadoÁrea
API-Key de LinearSolo referencia el nombre del secreto del workflow, el valor real se resuelve de forma segura en tiempo de ejecución. Crea el key en Linear → Settings → Security & access → Personal API keys.Protegido
AcciónOpciones: Crear issue, Listar issues, Actualizar issueEstándar
ID de equipoEl ID de equipo de Linear (UUID). Filtro opcional en "Listar issues", obligatorio en "Crear issue".Estándar
TítuloTítulo del issue.Estándar
DescripciónDescripción opcional (se admite Markdown).Estándar
Cantidad máximaCuántos issues cargar como máximo (por defecto 50, máximo 250).Estándar
ID del issueEl ID o identificador (p. ej. ENG-123) del issue a actualizar.Estándar
TítuloTítulo del issue.Estándar
DescripciónDescripción opcional (se admite Markdown).Estándar
ID del estadoOpcional, el ID del nuevo estado del issue (workflow state). Deja el estado sin cambios si está vacío.Estándar
Ejecutar una vez por elementoDesactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada.Estándar
Si un elemento falla«Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible.Estándar
Pausa entre elementos (milisegundos)Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos).Estándar

Entradas y salidas

EntradaSignificadoTipo
EstándarRecibe el resultado completo del paso anterior.JSON
SalidaSignificadoTipo
EstándarEntrega el resultado al paso siguiente como JSON.JSON

Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.

Ejemplo y prueba

Crear un reporte de bug como issue de Linear: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.

Ejemplo de prueba

{
  "action": "create_issue",
  "team_id": "team-eng",
  "title": "Checkout wirft 500 bei Rabattcode",
  "description": "Reproduziert mit Code SUMMER10 im Staging. Stacktrace im Anhang."
}

Acceso y seguridad

Antes de activarlo, revisa los datos que entran en este paso y el contenido de la salida.

Guarda claves y credenciales en el gestor protegido. No las pegues en campos normales, datos de prueba ni descripciones.

Resolver errores

  • Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
  • Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
  • La lista se procesa una sola vez: activa la ejecución por elemento.

Artículos relacionados