Workflows
Endpunkte für Workflow-Management und -Ausführung
https://app.meingpt.com/api/workflows/v1/user-workflowsBenutzer-Workflows abrufen
Ruft alle Workflows ab, auf die der authentifizierte Benutzer Zugriff hat
🔒 ApiKeyAuth
Parameter
| Parameter | In | Typ | Beschreibung |
|---|---|---|---|
| Authorization* | header | string | API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'. |
Responses
SuccessResponse & object
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
https://app.meingpt.com/api/workflows/v1/workflow-inputs/{workflowId}Workflow-Eingabevariablen abrufen
Ruft die Eingabevariablen/-parameter ab, die zum Ausführen eines bestimmten Workflows erforderlich sind
🔒 ApiKeyAuth
Parameter
| Parameter | In | Typ | Beschreibung |
|---|---|---|---|
| Authorization* | header | string | API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'. |
| workflowId* | path | string | Die Workflow-ID |
Responses
SuccessResponse & object
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
https://app.meingpt.com/api/workflows/v1/{workflowId}/runEinen Workflow ausführen
Führt einen Workflow mit den bereitgestellten Eingabeparametern aus
🔒 ApiKeyAuth
Parameter
| Parameter | In | Typ | Beschreibung |
|---|---|---|---|
| Authorization* | header | string | API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'. |
| workflowId* | path | string | Die Workflow-ID, die ausgeführt werden soll |
Request Body · application/json
| Feld | Typ | Beschreibung |
|---|---|---|
| input* | object | Eingabeparameter für die Workflow-Ausführung |
Responses
SuccessResponse & object
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
Timeout bei synchronen API-Aufrufen
Ein Workflow-Lauf über die API läuft synchron — es gibt keinen separaten Status- oder Polling-Endpunkt. Die Anfrage bleibt offen, bis der Workflow fertig ist oder ein Infrastruktur-Timeout eintritt, typischerweise nach ca. fünf Minuten. Plane Deine Workflows für API-Aufrufe so, dass sie deutlich innerhalb dieses Zeitfensters abschließen, oder löse sie asynchron über eine externe Automatisierung (z. B. Make) aus, die den Abschluss separat prüft.
Zusätzliche Dokumente pro Ausführung hochladen
Du kannst einem Workflow-Lauf zusätzliche Dokumente mitgeben (multipart/form-data-Request, max. 10 Dateien, max. 50 MB pro Datei — dieselbe Prüfung wie bei Assistenten-Läufen; Details in der API-Referenz).
Hinweis
Das Aktivieren/Deaktivieren von zusätzlichen Dokument-Uploads im Workflow-Editor beeinflusst nur die Chat-Oberfläche — API-Aufrufe können unabhängig davon immer Dateien mitschicken.
Antwort bei Dokument-Ausgabe
Ist der Workflow so konfiguriert, dass er ein Dokument erzeugt (z. B. DOCX, PDF, PPTX oder eine Tabellen-/Excel-Ausgabe), enthält die Antwort von POST /workflows/v1/{workflowId}/run nicht die Datei selbst. Stattdessen liefert das Feld documentUrl einen signierten Download-Link, der etwa eine Stunde gültig ist. Um die eigentliche Datei zu erhalten, muss ein zweiter Aufruf per GET gegen diese documentUrl erfolgen - erst diese Antwort enthält die Datei-Bytes mit passendem Content-Type und Content-Disposition.
Automatisierungen (z. B. Power Automate, Make, n8n), die das erzeugte Dokument weiterverarbeiten oder ablegen möchten, benötigen daher zwei Schritte: zuerst den Workflow-Run auslösen und documentUrl aus der Antwort auslesen, danach die Datei über einen zweiten HTTP-GET-Schritt herunterladen. Da der Link nach rund einer Stunde abläuft, sollte dieser zweite Schritt zeitnah erfolgen und nicht Teil eines lang laufenden, mehrstündigen Freigabeprozesses sein.
Schritte ohne Antwort (422)
Ein Schritt, der keinen Text erzeugt, lässt den Lauf mit 422 fehlschlagen, statt ein leeres content-Feld zurückzugeben. Die Meldung nennt die Schrittnummer und den Grund:
- Der Schritt hat seine 20 Tool-Aufruf-Schritte aufgebraucht, ohne zu antworten — meist zu viel Arbeit in einem Schritt oder Anhänge, die groß genug sind, dass das Modell das Budget mit Suchen verbraucht. Schritt aufteilen oder kleinere Dateien anhängen.
- Der Schritt hat das Output-Limit des Modells erreicht, bevor Text geschrieben wurde.
Praktischer Einsatz
- Workflow erstellen und testen: /platform/workflows-create
- Workflow in der Plattform nutzen: /platform/workflows
- Für API-Aufrufe immer zuerst Authentifizierung einrichten: /api/authentication