Workflow History Overview

What Is Workflow History?

Every time a workflow runs in BizFirstGO, it creates an execution record in the Process Engine. WorkDesk's Workflow History section surfaces the subset of executions that are relevant to you — those you started, or those where you were assigned a HIL task.

History is read-only from the employee perspective — you can see what happened and drill down for details, but you cannot modify or cancel executions from WorkDesk (that requires admin or designer roles).

History at a Glance

These summary counts appear at the top of the history section and update when the page loads.

What Qualifies for Your History?

An execution appears in your history if either condition is true:

• You triggered it — you are the triggeredBy actor (manually started the workflow)
• You participated in it — you acted on at least one HIL task in that execution (approved, submitted form, acknowledged review)

History API

GET /api/workdesk/executions
Authorization: Bearer {token}

// Query parameters
?status=completed
?workflowName=expense
?from=2026-05-01&to=2026-05-31
?triggerType=manual
?page=1&pageSize=25
?sortBy=triggeredAt&sortDir=desc

// Response
{
  "summary": { "running": 3, "completed": 42, "failed": 2, "suspended": 1 },
  "items": [ { ... execution records ... } ],
  "totalCount": 48,
  "page": 1,
  "pageSize": 25
}

Execution Record Fields