Workflow-Ausführungs-Export-API

Verwende die Workflow-Ausführungs-Export-API, um Daten zu Workflow-Ausführungen und Node-Ausführungen als JSON zu exportieren. Jede Zeile enthält Metadaten zur Ausführung, den Status der Node-Ausführung und detaillierte Ausführungsdaten, wenn du auf die Node zugreifen kannst.

Bevor du startest

Bevor du startest, stelle sicher, dass du Folgendes hast:

API-Schlüssel: Erstelle einen Workspace-API-Schlüssel mit dem WORKFLOW_API Scope unter Einstellungen > Workspace > Produkte > API, oder einen persönlichen API-Key, nachdem dein Admin die Workflow-Lese-API erlaubt und der Key diesen Scope enthält. Derselbe Lese-Scope gilt auch für Auflisten, Abrufen und paginierte Ausführungen. Diese Seite ist der flache Export. Workflow-Schreib-API und Workflow-Lösch-API stehen in der Workflow API Übersicht. Mehr dazu findest du unter Persönliche API-Keys.
Workflow-Zugriff: Der API-Schlüssel muss zu einem Workflow-Besitzer oder Bearbeiter gehören. Workspace-Administratoren können auch ohne eine Workflow-Freigabe auf Workflows zugreifen. Eine Freigabe mit der Rolle Benutzer gewährt keinen Zugriff auf diesen Endpunkt, auch nicht für Workspace-Administratoren.

Der API-Schlüssel eines Workspace-Administrators kann Daten im gesamten Workspace exportieren. Ein API-Schlüssel eines Nichtadministrators ist auf Workflows begrenzt, die diese Person besitzt oder bearbeiten darf. Gewähre diesen Scope nur vertrauenswürdigen Personen.

Basis-URL

Langdock Cloud
Dedicated Deployment

https://api.langdock.com

https://<deine-domain>/api/public

Endpunkt

GET /workflows/{workflowId}/runs

Du erhältst eine Zeile für jede Node-Ausführung. Eine Ausführung ohne Node-Ausführungen gibt eine Zeile mit null in den Node-Feldern zurück. Für paginierte Ausführungen mit Node-Payloads und Filtern wie runMode nutze Workflow-Ausführungen auflisten.

Authentifizierung

Sende deinen API-Schlüssel als Bearer-Token:

cURL

curl "https://api.langdock.com/workflows/550e8400-e29b-41d4-a716-446655440000/runs?from=2026-08-01&to=2026-08-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ersetze bei einem Dedicated Deployment https://api.langdock.com durch die Basis-URL deines Deployments.

Parameter

Parameter	Ort	Typ	Erforderlich	Beschreibung
`workflowId`	Pfad	string	Ja	ID des zu exportierenden Workflows. Muss eine gültige GUID sein.
`from`	Query	string	Ja	Beginn des Exportzeitraums für den Erstellungszeitpunkt der Ausführung. Verwende ein ISO-8601-Datum oder einen Zeitstempel. Ein Datum ohne Uhrzeit beginnt um `00:00:00.000` UTC.
`to`	Query	string	Ja	Ende des Exportzeitraums für den Erstellungszeitpunkt der Ausführung. Verwende ein ISO-8601-Datum oder einen Zeitstempel. Ein Datum ohne Uhrzeit endet um `23:59:59.999` UTC. Der Wert muss gleich oder später als `from` sein.

Füge bei vollständigen Zeitstempeln Z oder einen expliziten UTC-Offset hinzu. Ein Zeitstempel ohne Zeitzone wird in der lokalen Zeitzone des Servers interpretiert. Beide Datumswerte sind erforderlich. Die API verwendet keinen Standardzeitraum. Du erhältst alle Node-Ausführungen einer passenden Workflow-Ausführung, auch wenn die Node-Ausführung außerhalb des Zeitraums liegt.

Antwort

Du erhältst ein data-Array mit flachen Zeilen zu Workflow-Ausführungen und Node-Ausführungen:

Erfolg

{
  "data": [
    {
      "run_id": "7d2a1c4e-2f6a-4b9f-8c31-1a6d8e4f2b90",
      "run_number": 42,
      "run_status": "COMPLETED",
      "run_created_at": "2026-08-12T09:15:00.000Z",
      "run_updated_at": "2026-08-12T09:15:08.000Z",
      "workflow_version": "3",
      "trigger_mode": "WEBHOOK",
      "node_execution_id": "2b8c1d4e-6f7a-4b90-9c12-3d5e7f8a1b20",
      "node_id": "9c1f2d3e-7a4b-4c58-8d19-2e6f0b7a4c31",
      "node_type": "agent",
      "node_status": "COMPLETED",
      "node_created_at": "2026-08-12T09:15:01.000Z",
      "node_updated_at": "2026-08-12T09:15:06.000Z",
      "failure_code": null,
      "input": {
        "customer_id": "customer-42"
      },
      "input_error": null,
      "output": {
        "category": "support"
      },
      "output_error": null,
      "logs": [],
      "data_redacted": false,
      "execution_data_expired_at": null
    }
  ]
}

Die Zeilen sind vom ältesten zum neuesten Erstellungszeitpunkt der Workflow-Ausführung und dann nach dem Erstellungszeitpunkt der Node-Ausführung sortiert. Der Endpunkt verwendet keine Pagination. Verwende einen kürzeren Zeitraum, um die Antwort zu verkleinern.

Antwortfelder

Feld	Typ	Beschreibung
`run_id`	string	ID der Workflow-Ausführung.
`run_number`	number	Fortlaufende Nummer der Ausführung innerhalb des Workflows.
`run_status`	string	Status der Workflow-Ausführung: `PENDING`, `IN_PROGRESS`, `AWAITING_INPUT`, `COMPLETED`, `FAILED` oder `CANCELLED`.
`run_created_at`	string	Erstellungszeit der Workflow-Ausführung im ISO-8601-Format.
`run_updated_at`	string	Zeitpunkt der letzten Aktualisierung der Workflow-Ausführung im ISO-8601-Format.
`workflow_version`	string	Für die Ausführung verwendete Workflow-Version. Version `0` ist die Entwurfsversion des Workflows. Der öffentliche Endpunkt bietet keinen Filter für Test- oder Produktionsausführungen.
`trigger_mode`	string oder null	Modus, der die Ausführung gestartet hat: `WEBHOOK`, `FORM`, `SCHEDULED`, `INTEGRATION_POLLING` oder `MANUAL`.
`node_execution_id`	string oder null	ID der Node-Ausführung.
`node_id`	string oder null	ID der Workflow-Node.
`node_type`	string oder null	Typ der Workflow-Node.
`node_status`	string oder null	Status der Node-Ausführung: `NONE`, `IN_PROGRESS`, `AWAITING_INPUT`, `COMPLETED`, `FAILED` oder `CANCELLED`.
`node_created_at`	string oder null	Erstellungszeit der Node-Ausführung im ISO-8601-Format.
`node_updated_at`	string oder null	Zeitpunkt der letzten Aktualisierung der Node-Ausführung im ISO-8601-Format.
`failure_code`	string oder null	Fehlercode, wenn die Node-Ausführung fehlschlägt.
`input`	JSON-Wert oder null	Eingabedaten der Node-Ausführung.
`input_error`	JSON-Wert oder null	Fehlerdaten der Node-Eingabe.
`output`	JSON-Wert oder null	Ausgabedaten der Node-Ausführung.
`output_error`	JSON-Wert oder null	Fehlerdaten der Node-Ausgabe.
`logs`	JSON-Wert oder null	Während der Node-Ausführung erstellte Logs.
`data_redacted`	boolean	Gibt an, ob die API Payload-Felder ausgelassen hat, weil du nicht auf die Node-Daten zugreifen kannst oder der Endpunkt den Zugriff darauf nicht feststellen kann.
`execution_data_expired_at`	string oder null	Zeitpunkt, zu dem detaillierte Ausführungsdaten abgelaufen sind, im ISO-8601-Format.

Die Felder input und output sind bei Ausführungsdaten, die älter als 30 Tage sind, null. Alle fünf Payload-Felder sind null, wenn der Endpunkt keinen Zugriff auf die Node-Daten feststellen kann. Das kann passieren, wenn dein Workflow-Zugriff die von der Ausführung verwendete Action oder den Agenten nicht einschließt. Die API setzt data_redacted in diesem Fall auf true. Bei Payload-Werten über 16.000 Bytes gibt die API einen Kürzungsmarker zurück. Der Marker enthält ein _truncated-Objekt mit den Feldern originalBytes, maxBytes und message. Die Antwort enthält nicht die Identität der Person oder Gruppe, die eine Ausführung gestartet hat.

Limits und Aufbewahrung

Jede Anfrage kann bis zu 10.000 Workflow-Ausführungen exportieren.
Eingabe- und Ausgabedaten werden 30 Tage lang aufbewahrt.
Die Payload-Daten einer Antwort sind auf 8.000.000 Bytes begrenzt.

Wenn eine Anfrage mehr als 10.000 Ausführungen enthält, gibt sie 400 Bad Request mit dem Code WORKFLOW_RUN_EXPORT_LIMIT_EXCEEDED zurück. Wenn die Payload-Daten 8.000.000 Bytes überschreiten, gibt sie 400 Bad Request mit dem Code WORKFLOW_RUN_EXPORT_TOO_LARGE zurück. Verwende einen kürzeren Zeitraum, um beide Fehler zu vermeiden.

Rate Limits

Der Endpunkt erlaubt 500 Anfragen pro Minute je Workspace und API-Schlüssel. Anfragen über diesem Limit geben 429 Too Many Requests zurück.

Fehlerbehandlung

Statuscode	Beschreibung
`400`	Die Anfrage ist ungültig. Dazu gehören eine ungültige Workflow-ID oder ein ungültiges Datum, ein `to`-Wert vor `from`, ein Export mit mehr als 10.000 Ausführungen oder Payload-Daten über 8.000.000 Bytes.
`401`	Der API-Schlüssel fehlt oder ist ungültig.
`403`	Der API-Schlüssel hat nicht den `WORKFLOW_API` Scope oder sein Besitzer ist nicht der Workflow-Besitzer, Bearbeiter oder Workspace-Administrator. Eine Freigabe mit der Rolle Benutzer gewährt keinen Zugriff, auch nicht für Workspace-Administratoren.
`405`	Die Anfrage verwendet eine andere Methode als `GET`.
`429`	Der Workspace und der API-Schlüssel haben das Anfrage-Limit überschritten.
`500`	Ein unerwarteter Serverfehler ist aufgetreten.

Fehler

{
  "message": "Workflow run exports are limited to 10,000 runs. Select a smaller date range.",
  "code": "WORKFLOW_RUN_EXPORT_LIMIT_EXCEEDED",
  "details": {
    "maxRuns": 10000
  }
}

Fehlerhafte Query-Parameter geben {"message":"Invalid request","errors":[...]} ohne code-Feld zurück. Ein ungültiges Datum oder ein to-Wert vor from gibt code: "BAD_REQUEST" zurück.

Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in den Best Practices für API-Schlüssel.

Überblick

Completion API

Embedding API

Agents API

Integrations API

Skills API

Knowledge Folder API

Prompt Library API

Usage Export API

Workflow API

Scheduled Tasks API

User Management API

Billing API

Audit Logs API

Governance API

Compliance API

Workflow-Ausführungs-Export-API

Bevor du startest

Basis-URL

Endpunkt

Authentifizierung

Parameter

Antwort

Antwortfelder

Limits und Aufbewahrung

Rate Limits

Fehlerbehandlung

​Bevor du startest

​Basis-URL

​Endpunkt

​Authentifizierung

​Parameter

​Antwort

​Antwortfelder

​Limits und Aufbewahrung

​Rate Limits

​Fehlerbehandlung

Bevor du startest

Basis-URL

Endpunkt

Authentifizierung

Parameter

Antwort

Antwortfelder

Limits und Aufbewahrung

Rate Limits

Fehlerbehandlung