---
title: "Export workflow run data"
method: GET
path: "/workflows/{workflowId}/runs"
tags: ["Workflow Run Export"]
---

# Export workflow run data

`GET /workflows/{workflowId}/runs`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/workflows/{workflowId}/runs`
- Auth: HTTP bearer

Returns flattened workflow run and node execution rows for the selected
workflow. The date range filters workflow run creation time. The
endpoint requires a workspace API key with the `WORKFLOW_API` scope and
owner or editor access. Workspace administrators can access workflows
without a workflow share, but a User share does not grant access.

## Path parameters

- `workflowId` string, uuid, required

## Query parameters

- `from` string, required
- `to` string, required

## Response `200`

Workflow run export

- WorkflowRunExportResponse: Flattened workflow run and node execution rows.
  - `data` WorkflowRunExportRow[], required
    - `run_id` string, uuid, required: ID of the workflow run.
    - `run_number` integer, required: Sequential number of the run within the workflow.
    - `run_status` 'PENDING' | 'IN_PROGRESS' | 'AWAITING_INPUT' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required: Status of the workflow run.
    - `run_created_at` string, date-time, required: Creation time of the workflow run.
    - `run_updated_at` string, date-time, required: Last update time of the workflow run.
    - `workflow_version` string, required: Version of the workflow used for the run.
    - `trigger_mode` 'WEBHOOK' | 'FORM' | 'SCHEDULED' | 'INTEGRATION_POLLING' | 'MANUAL', nullable, required: Mode that triggered the run.
    - `node_execution_id` string, uuid, nullable, required: ID of the node execution.
    - `node_id` string, uuid, nullable, required: ID of the workflow node.
    - `node_type` string, nullable, required: Type of the workflow node.
    - `node_status` 'NONE' | 'IN_PROGRESS' | 'AWAITING_INPUT' | 'COMPLETED' | 'FAILED' | 'CANCELLED', nullable, required: Status of the node execution.
    - `node_created_at` string, date-time, nullable, required: Creation time of the node execution.
    - `node_updated_at` string, date-time, nullable, required: Last update time of the node execution.
    - `failure_code` string, nullable, required: Failure code when the node execution fails.
    - `input` union, required: Input data for the node execution.
      - object
      - unknown[]
        - unknown
      - string
      - number
      - boolean
    - `input_error` union, required: Error data for the node input.
      - object
      - unknown[]
        - unknown
      - string
      - number
      - boolean
    - `output` union, required: Output data for the node execution.
      - object
      - unknown[]
        - unknown
      - string
      - number
      - boolean
    - `output_error` union, required: Error data for the node output.
      - object
      - unknown[]
        - unknown
      - string
      - number
      - boolean
    - `logs` union, required: Logs generated during the node execution.
      - object
      - unknown[]
        - unknown
      - string
      - number
      - boolean
    - `data_redacted` boolean, required: Whether payload fields were omitted because access to the node data could not be established.
    - `execution_data_expired_at` string, date-time, nullable, required: Time when detailed execution data expired.

## Other responses

- `400`: Invalid request or export exceeds a configured limit
- `401`: Missing or invalid API key
- `403`: Missing scope or workflow access
- `405`: Method not allowed
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/workflows/:workflowId/runs/get.md)

---

[API](https://skmtc.dev/langdock/apis/langdock-api.md) - [All operations](https://skmtc.dev/langdock/apis/langdock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdock/apis/langdock-api/revisions/c62bf90b4013?raw)