Status Badges
Execution status is communicated through consistent color-coded badges. These are the same status values used in Flow Studio's Observer Panel — ensuring a uniform visual language across the platform.
Status Reference
Color: Blue (var(--info))
Meaning: Workflow is actively executing — nodes are being processed right now.
Action: No action needed. You can drill down to watch progress in the Observer Panel.
Color: Green (var(--success))
Meaning: All nodes finished successfully. The workflow reached its terminal state.
Action: Review output preview or drill down to see final results.
Color: Red (var(--danger))
Meaning: A node encountered an unrecoverable error. The workflow stopped.
Action: Drill down → Observer Panel → Logs tab to see which node failed and why. Contact your workflow admin.
Color: Yellow (var(--warning))
Meaning: Workflow is paused at a HIL node waiting for a human response.
Action: Check your HIL Inbox — there may be a pending task for this execution.
Color: Gray
Meaning: Execution was manually cancelled by an admin, or a timeout expired at a HIL node.
Action: No further action. The execution is terminal. If cancelled unexpectedly, contact your admin.
Status Enum (API)
// Execution status enum — same values used in WorkDesk and Flow Studio
type ExecutionStatus =
| 'running' // currently executing nodes
| 'completed' // terminal — all nodes finished successfully
| 'failed' // terminal — unrecoverable error
| 'suspended' // paused at HIL node — waiting for human input
| 'cancelled'; // terminal — manually cancelled or timeout expiredSub-Statuses
Executions in certain states have additional sub-status information shown in the Observer Panel (not in the list view):
| Status | Sub-Status | Meaning |
|---|---|---|
| Suspended | awaiting_approval | Paused at an approval HIL node |
| Suspended | awaiting_form | Paused at a form HIL node |
| Suspended | awaiting_review | Paused at a review HIL node |
| Suspended | awaiting_multiple | Multi-party — waiting for multiple actors |
| Failed | node_error | A specific node threw an exception |
| Failed | timeout | Execution exceeded the workflow's max duration setting |
| Cancelled | manual | Admin or designer explicitly cancelled |
| Cancelled | hil_timeout | HIL node exceeded its dueAt and the timeout handler cancelled the execution |
Color System Consistency
WorkDesk uses the same CSS color variables as Flow Studio Observer Panel for all status indicators. This ensures employees who switch between WorkDesk and Observer Panel see identical color coding with no relearning needed.
/* Status color mapping — consistent across WorkDesk and Flow Studio */
const STATUS_COLORS: Record<ExecutionStatus, string> = {
running: 'var(--info)', // blue
completed: 'var(--success)', // green
failed: 'var(--danger)', // red
suspended: 'var(--warning)', // yellow
cancelled: '#9ca3af', // gray
};