WorkDesk
Workflow History Filters
Workflow History filters let you narrow down the execution list to exactly the records you need. Filter by status, date range, workflow name, trigger type, and your role in the execution. Filters are URL-synced for bookmarking and sharing.
Available History Filters
| Filter | Options | API Parameter |
|---|---|---|
| Status | All, Running, Completed, Failed, Suspended, Cancelled | ?status=failed |
| Date Range (From) | Date picker — ISO 8601 | ?from=2026-05-01 |
| Date Range (To) | Date picker — ISO 8601 | ?to=2026-05-31 |
| Workflow Name | Free text partial match (case-insensitive) | ?workflowName=payroll |
| Trigger Type | All, Manual, Scheduled, Webhook, API | ?triggerType=scheduled |
| Your Role | All, Triggered by Me, HIL Respondent | ?role=triggerer |
Date Range Presets
The date range filter includes one-click preset options to avoid manual date entry for common intervals:
| Preset | from / to Values |
|---|---|
| Today | today 00:00 → today 23:59 |
| Yesterday | yesterday 00:00 → yesterday 23:59 |
| This Week | Monday 00:00 → Sunday 23:59 |
| Last 7 Days | now - 7 days → now |
| This Month | 1st of month → today |
| Last 30 Days | now - 30 days → now |
| Custom Range | User-selected via calendar picker |
URL-Synced Filter Example
// URL when filters are applied
/workdesk/history?status=failed&from=2026-05-01&to=2026-05-31&workflowName=payroll
// Shareable: send this URL to a colleague and they see the same filtered view
// (subject to their own data access rights)
// React hook — read filters from URL on mount
import { useSearchParams } from 'react-router-dom';
function useHistoryFiltersFromUrl(): HistoryFilterState {
const [searchParams] = useSearchParams();
return {
status: (searchParams.get('status') ?? 'all') as ExecutionStatus | 'all',
from: searchParams.get('from') ?? '',
to: searchParams.get('to') ?? '',
workflowName: searchParams.get('workflowName') ?? '',
triggerType: (searchParams.get('triggerType') ?? 'all') as string,
role: (searchParams.get('role') ?? 'all') as string,
};
}Combining Filters
Common filter combinations for Workflow History:
- Failed executions this month — Status=Failed, Date=This Month
- Workflows I triggered manually — Role=Triggered by Me, TriggerType=Manual
- All scheduled payroll runs — WorkflowName=payroll, TriggerType=Scheduled
- Currently suspended executions — Status=Suspended