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 |
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 (deutlich unter einer Minute). Plane Deine Workflows für API-Aufrufe entsprechend kurz, 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. 150 MB pro Datei — für den tatsächlich aktuell durchgesetzten Wert siehe die API-Referenz, da hier dieselbe Prüfung wie bei Assistenten-Läufen gilt).
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.
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