---
title: "Create workflow data export"
method: GET
path: "/v4/workflows/{workflowId}/data/export"
tags: ["Workflows"]
---

# Create workflow data export

`GET /v4/workflows/{workflowId}/data/export`

## Request

- Base URL: `https://api.kadoa.com`
- URL: `https://api.kadoa.com/v4/workflows/{workflowId}/data/export`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Materializes the full result set as CSV, JSON, or Parquet to object storage and returns a self-authenticating
URL that can be opened by external clients (Claude Desktop, Claude for Excel, code execution sandboxes,
browsers) without an Authorization header. The URL is HMAC-signed and bound to the exportId, workflowId,
format and expiry.

## Path parameters

- `workflowId` string, required

## Query parameters

- `format` 'csv' | 'json' | 'parquet'
- `runId` string
- `filters` string
- `sortBy` string
- `order` 'asc' | 'desc'
- `rowIds` string

## Response `200`

Export materialized

- object
  - `workflowId` string, required
  - `runId` string, required
  - `executedAt` string, date-time
  - `format` 'csv' | 'json' | 'parquet', required
  - `rowCount` integer, required
  - `url` string, required: Signed, self-authenticating download URL. Valid until expiresAt.
  - `expiresAt` string, date-time, required

## Other responses

- `400`: Invalid query params
- `401`: Unauthorized
- `404`: Workflow or run not found
- `409`: No workflow run is published, or the producing run schema is unavailable

---

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