DokumentationWorkflowsHTTP und Entwicklerwerkzeuge
Linear Node
Erstelle, liste und aktualisiere Linear-Issues direkt aus deinem Workflow, über die offizielle Linear GraphQL-API (ein Endpoint für alles). Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.
8 Min LesezeitAktualisiert am
Was Linear macht
Erstelle, liste und aktualisiere Linear-Issues direkt aus deinem Workflow, über die offizielle Linear GraphQL-API (ein Endpoint für alles).
- Verarbeitet einen Eingang.
- Stellt einen Ausgang für weitere Schritte bereit.
- Wird als normaler Schritt in den Ablauf eingebunden.
Node einrichten
- 01Öffne einen Workflow und füge „Linear“ über Bausteine hinzu.
- 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
- 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
- 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.
Aktionen und Betriebsarten
Wähle im Feld „Aktion“ die gewünschte Funktion. Danach zeigt das Node-Panel nur die dafür relevanten Einstellungen.
- Issue anlegen
- Issues auflisten
- Issue aktualisieren
Einstellungen
| Feld | Bedeutung | Bereich |
|---|---|---|
| Linear API-Key | Verweist nur auf den Namen des Workflow-Secrets, der Key selbst wird erst zur Laufzeit sicher aufgelöst. Erstelle den Key unter Linear → Einstellungen → Security & access → Personal API keys. | Standard |
| Aktion | Auswahl: Issue anlegen, Issues auflisten, Issue aktualisieren | Standard |
| Team-ID | Die Linear-Team-ID (UUID). Bei „Issues auflisten“ optional als Filter, bei „Issue anlegen“ zwingend erforderlich. | Standard |
| Titel | Titel des Issues. | Standard |
| Beschreibung | Optionale Beschreibung (Markdown wird unterstützt). | Standard |
| Maximale Anzahl | Wie viele Issues maximal geladen werden (Standard 50, maximal 250). | Standard |
| Issue-ID | Die ID oder der Identifier (z.B. ENG-123) des zu aktualisierenden Issues. | Standard |
| Neuer Titel | Optional, lässt den Titel unverändert, wenn leer. | Standard |
| Neue Beschreibung | Optional, lässt die Beschreibung unverändert, wenn leer. | Standard |
| Status-ID | Optional, die ID des neuen Issue-Status (Workflow State). Lässt den Status unverändert, wenn leer. | Standard |
| Für jedes Item einzeln ausführen | Aus (Standard): der Node läuft einmal für den gesamten Input. An: bekommt er mehrere Items (z. B. aus „Liste aufteilen“), läuft er einmal PRO Item, und {{ $json }} ist dabei jeweils genau dieses Item. So arbeitest du eine Dateiliste Eintrag für Eintrag ab. | Erweitert |
| Wenn ein Item fehlschlägt | „Überspringen“ schreibt für das fehlgeschlagene Item ein `error`-Feld und verarbeitet die übrigen weiter, statt den ganzen Lauf an einer einzigen unlesbaren Datei scheitern zu lassen. | Erweitert |
| Pause zwischen Items (Millisekunden) | Wartezeit vor jedem Durchlauf außer dem ersten. 1000 = 1 Sekunde pro Item. Nützlich, wenn die Gegenstelle sonst dichtmacht. Maximal 300000 (5 Minuten). | Erweitert |
Eingaben und Ausgaben
| Eingabe | Bedeutung | Typ |
|---|---|---|
| Standard | Der Node übernimmt das vollständige Ergebnis des vorherigen Schritts. | JSON |
| Ausgabe | Bedeutung | Typ |
|---|---|---|
| Standard | Das Ergebnis steht dem nächsten Schritt als JSON zur Verfügung. | JSON |
Dieser Node kann Listen Item für Item verarbeiten. Fehlerbehandlung und Pause zwischen Items findest du in den erweiterten Einstellungen.
Beispiel und Testlauf
Neuen Bug-Report als Linear-Issue anlegen: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.
Beispiel für einen Testlauf
{
"action": "create_issue",
"team_id": "team-eng",
"title": "Checkout wirft 500 bei Rabattcode",
"description": "Reproduziert mit Code SUMMER10 im Staging. Stacktrace im Anhang."
}Zugriff und Sicherheit
Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.
Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.
Häufige Fehler beheben
- Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
- Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.
- Liste wird nur einmal verarbeitet: Aktiviere die Ausführung pro Item in den erweiterten Einstellungen.