Skip to main content
GET
List workflow runs
Gibt paginierte Ausführungen und Node-Ausführungen für einen Workflow zurück, den der API-Key-User bearbeiten kann. Nutze diesen Pfad, wenn du Filter wie Test gegen Produktion oder einen Cursor brauchst. Der flache, datumsbegrenzte Export ist ein anderer Vertrag unter Workflow-Ausführungs-Export-API.

Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

Erforderliche Scopes

Dieser Endpoint erfordert den WORKFLOW_API Scope (Workflow-Lese-API) und Bearbeiterzugriff.

Parameter

Nicht verfügbare Action- oder Agent-Daten werden redigiert. Ausführungs-Payloads folgen dem Payload-Limit der Workflow API.

Beispiel

Antwortformat

Erfolgreiche Antwort (200 OK)

Fehlerbehandlung

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 unserem Guide zu Best Practices für API-Schlüssel.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Abfrageparameter

workflowId
string<uuid>
erforderlich

UUID of the workflow.

limit
integer
Standard:50

Number of runs to return.

Erforderlicher Bereich: 1 <= x <= 100
cursor
string<uuid>

Run UUID from nextCursor in the previous response.

runId
string<uuid>

Filter to a single run UUID.

runMode
enum<string>
Verfügbare Optionen:
test,
production
status
enum<string>
Verfügbare Optionen:
PENDING,
IN_PROGRESS,
AWAITING_INPUT,
COMPLETED,
FAILED,
CANCELLED
from
string

Start of the run creation range. ISO 8601 timestamp or YYYY-MM-DD. Must be sent together with to.

to
string

End of the run creation range. Must be equal to or later than from.

version
string

Workflow version used for the run. Version 0 is the draft used for test runs.

Antwort

Workflow runs returned successfully