Exporting History
Employees can export their workflow execution history as a CSV file — useful for personal record-keeping, reporting to a manager, or providing evidence for an audit. The export respects active filters, so you can export exactly the slice of history you need.
Export Options
| Option | Description |
|---|---|
| Format | CSV (comma-separated values) — opens in Excel, Google Sheets, or any spreadsheet |
| Scope | Exports the current filter selection — same records visible in the list |
| Date Range | Required — maximum 90 days per export to prevent very large files |
| Column Selection | Optional — choose which columns to include (default: all) |
Export API
// Export execution history as CSV
GET /api/workdesk/executions/export
Authorization: Bearer {token}
Accept: text/csv
// Query parameters — same as history list
?from=2026-05-01&to=2026-05-31
&status=completed
&workflowName=expense
&format=csv
// Response: 200 OK
// Content-Type: text/csv
// Content-Disposition: attachment; filename="workdesk-history-2026-05.csv"
ExecutionId,WorkflowName,Status,TriggeredAt,CompletedAt,DurationMs,TriggerType,YourRole
7bc12d45-...,Expense Approval Flow,completed,2026-05-25T09:12:00Z,2026-05-25T09:45:00Z,1980000,manual,triggerer
...CSV Column Reference
| Column | Description |
|---|---|
ExecutionId | Unique execution GUID |
WorkflowName | Workflow display name |
WorkflowId | Workflow definition ID |
Status | running / completed / failed / suspended / cancelled |
TriggeredAt | ISO 8601 UTC start time |
CompletedAt | ISO 8601 UTC end time (empty if still running) |
DurationMs | Duration in milliseconds |
TriggerType | manual / scheduled / webhook / api |
YourRole | triggerer / hil-respondent |
OutputSummary | Key output fields as JSON string (optional — large exports may omit) |
How to Export
Apply Filters
Set the date range and any other filters. The export will contain exactly the executions currently visible in the list.
Click Export
Click the Export CSV button in the top-right of the history section. A dialog confirms the export scope and lets you choose columns.
Download Starts
The browser downloads the CSV file immediately. For large exports (>500 rows), the server streams the response — the download starts as soon as the first rows are ready.
Single exports are limited to 90 days of data and 5,000 execution records. For larger exports, apply date range filters to split the export into multiple files. Admin-level bulk exports are available in the Admin Panel.