Skip to main content
GET
Export workflow run data
Use the Workflow Run Export API to export workflow run and node execution data as JSON. Each row gives you run metadata, node status, and detailed execution data when you have access to the node.

Before you start

Before you start, make sure you have:
  • Workspace API key: Create a workspace API key with the WORKFLOW_API scope under Settings > Workspace > Products > API. Personal API keys only support the Completion APIs. See Personal API keys.
  • Workflow access: The API key must belong to a workflow owner or editor. Workspace administrators can also access workflows without a workflow share. A workflow shared with the User role does not grant access to this endpoint, including for workspace administrators.
A workspace administrator’s API key can export data across the workspace. An API key owned by a non-administrator is limited to workflows that person owns or can edit. Only grant this scope to trusted users.

Base URL

Endpoint

You receive one row for each node execution. A run without node executions returns one row with null node fields.

Authentication

Send your API key as a Bearer token:
cURL
For a dedicated deployment, replace https://api.langdock.com with your deployment base URL.

Parameters

Include Z or an explicit UTC offset in full timestamps. A timestamp without a timezone is interpreted in the server’s local timezone. Both date values are required. The API does not apply a default date range. You receive every node execution for a matching run, even if the node execution falls outside the date range.

Response

You receive a data array with flattened workflow run and node execution rows:
Success
Rows are ordered from oldest to newest by run creation time and then node execution creation time. The endpoint does not paginate. Use a narrower date range to reduce the response size.

Response fields

The input and output fields are null for execution data older than 30 days. All five payload fields are null when the endpoint cannot establish access to the node’s data. This can happen when your workflow access does not include an action or agent node used by the execution. The API sets data_redacted to true in that case. For payload values larger than 16,000 bytes, the API returns a truncation marker. The marker contains an _truncated object with originalBytes, maxBytes, and message fields. The response does not include the identity of the person or group that triggered a run.

Limits and retention

  • Each request can export up to 10,000 workflow runs.
  • Input and output data is retained for 30 days.
  • Payload data in one response is limited to 8,000,000 bytes.
If a request exceeds 10,000 runs, it returns 400 Bad Request with the WORKFLOW_RUN_EXPORT_LIMIT_EXCEEDED code. If the payload data exceeds 8,000,000 bytes, it returns 400 Bad Request with the WORKFLOW_RUN_EXPORT_TOO_LARGE code. Use a smaller date range to resolve either error.

Rate limits

The endpoint allows 500 requests per minute for each workspace and API key. Requests above the limit return 429 Too Many Requests.

Error handling

Error
Malformed query parameters return {"message":"Invalid request","errors":[...]} without a code field. An invalid date or a to value earlier than from returns code: "BAD_REQUEST".
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, see API Key Best Practices.

Authorizations

Authorization
string
header
required

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Path Parameters

workflowId
string<uuid>
required

ID of the workflow to export.

Query Parameters

from
string
required

Start of the export range. Use an ISO 8601 date or timestamp. A date-only value starts at 00:00:00.000 UTC.

to
string
required

End of the export range. Use an ISO 8601 date or timestamp. A date-only value ends at 23:59:59.999 UTC.

Response

Workflow run export

Flattened workflow run and node execution rows.

data
object[]
required