> ## Documentation Index > Fetch the complete documentation index at: https://docs.langdock.com/llms.txt > Use this file to discover all available pages before exploring further. # Workflow-Ausführungen auflisten > Lies paginierte Workflow-Ausführungen mit Node-Eingaben, Ausgaben, Fehlern und Logs 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](/de/developer/workflow-api/intro-to-workflow-api). ## Basis-URL ``` https://api.langdock.com/workflows/v1/runs ``` **Dedicated Deployments** Ersetze `api.langdock.com` durch `/api/public` in allen Anfragen. ## Erforderliche Scopes Dieser Endpoint erfordert den `WORKFLOW_API` Scope (**Workflow-Lese-API**) und Bearbeiterzugriff. ## Parameter | Parameter | Typ | Erforderlich | Beschreibung | | ------------ | ------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workflowId` | string | Ja | UUID des Workflows. | | `limit` | integer | Nein | Anzahl der zurückzugebenden Ausführungen. Standard: `50`. Maximum: `100`. | | `cursor` | string | Nein | Run-UUID aus `nextCursor` der vorherigen Antwort. | | `runId` | string | Nein | Filter auf eine einzelne Run-UUID. | | `runMode` | string | Nein | `test` oder `production`. Muss zu `version` passen, wenn beide gesetzt sind: `test` mit `0`, Produktion mit einer veröffentlichten Version. | | `status` | string | Nein | Ausführungsstatus: `PENDING`, `IN_PROGRESS`, `AWAITING_INPUT`, `COMPLETED`, `FAILED` oder `CANCELLED`. | | `from` | string | Nein | Start des Erstellungszeitraums. ISO-8601-Zeitstempel oder `YYYY-MM-DD`. Muss zusammen mit `to` gesendet werden. Ein reines Datum startet um `00:00:00.000` UTC. | | `to` | string | Nein | Ende des Erstellungszeitraums. Muss gleich oder später als `from` sein. Ein reines Datum endet um `23:59:59.999` UTC. | | `version` | string | Nein | Workflow-Version der Ausführung. Version `0` ist der Entwurf für Testläufe. | Nicht verfügbare Action- oder Agent-Daten werden redigiert. Ausführungs-Payloads folgen dem Payload-Limit der Workflow API. ## Beispiel ```javascript theme={null} const axios = require("axios"); async function listWorkflowRuns(workflowId) { const response = await axios.get( "https://api.langdock.com/workflows/v1/runs", { params: { workflowId, runMode: "production", limit: 50 }, headers: { Authorization: "Bearer YOUR_API_KEY" } } ); console.log("Runs:", response.data.runs.length); return response.data.nextCursor; } listWorkflowRuns("550e8400-e29b-41d4-a716-446655440000"); ``` ## Antwortformat ### Erfolgreiche Antwort (200 OK) ```typescript theme={null} { runs: Array<{ id: string; runNumber: number; status: string; createdAt: string; updatedAt: string; isTestRun: boolean; isExecutionDataExpired: boolean; workflowVersion: { id: string; version: string; nodes: Array; edges: Array; }; executions: Array<{ id: string; workflowNodeId: string; createdAt: string; updatedAt: string; status: string; input: unknown; output: unknown; inputError: unknown; outputError: unknown; logs: unknown; durationMs: number; executionDataExpiredAt: string | null; accessDenied: boolean; }>; tags: Array<{ key: string; displayValue: string | null }>; rerunOf: { id: string; runNumber: number } | null; originalRerunOf: { id: string; runNumber: number } | null; }>; nextCursor?: string; hasWaitingForInput: boolean; } ``` ## Fehlerbehandlung | Statuscode | Beschreibung | | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 400 | Ungültige Query, `from` ohne `to`, `to` früher als `from`, oder `runMode`, das nicht zu `version` passt | | 401 | Ungültiger oder fehlender API-Key | | 403 | Fehlender `WORKFLOW_API` Scope oder Bearbeiterzugriff. Ein fehlender Workflow, eine Vorlage oder ein Workflow in einem anderen Workspace gibt denselben Status zurück. | | 429 | Rate Limit überschritten | | 500 | Interner Serverfehler | 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](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices). ## OpenAPI ````yaml GET /workflows/v1/runs openapi: 3.0.0 info: title: Langdock API version: 3.0.0 servers: - url: https://api.langdock.com description: Production security: - bearerAuth: [] paths: /workflows/v1/runs: get: tags: - Workflows summary: List workflow runs description: >- Returns paginated runs and node executions for a workflow the API key user can edit. operationId: listWorkflowRuns parameters: - name: workflowId in: query required: true schema: type: string format: uuid description: UUID of the workflow. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 50 description: Number of runs to return. - name: cursor in: query required: false schema: type: string format: uuid description: Run UUID from nextCursor in the previous response. - name: runId in: query required: false schema: type: string format: uuid description: Filter to a single run UUID. - name: runMode in: query required: false schema: type: string enum: - test - production - name: status in: query required: false schema: type: string enum: - PENDING - IN_PROGRESS - AWAITING_INPUT - COMPLETED - FAILED - CANCELLED - name: from in: query required: false schema: type: string description: >- Start of the run creation range. ISO 8601 timestamp or YYYY-MM-DD. Must be sent together with to. - name: to in: query required: false schema: type: string description: End of the run creation range. Must be equal to or later than from. - name: version in: query required: false schema: type: string description: >- Workflow version used for the run. Version 0 is the draft used for test runs. responses: '200': description: Workflow runs returned successfully '400': description: >- Invalid query, from without to, to earlier than from, or runMode that disagrees with version '401': description: Invalid or missing API key '403': description: >- Missing WORKFLOW_API scope or editor access. A missing workflow, a template, or a workflow in another workspace also returns this status. '429': description: Rate limit exceeded '500': description: Internal server error components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: API key as Bearer token. Format "Bearer YOUR_API_KEY" ````