Technical

Understanding Flow Instance Statuses

Last updated 03 June 2026

Understanding Flow Instance Statuses

When a flow is triggered, an instance is created to track that specific run from start to finish. Every instance has a status that tells you where it is in its lifecycle.

Pending

The instance is active and in progress. At least one step is currently assigned and waiting for someone to complete it.

This is the normal state for flows that have been started but not yet finished. Most instances spend the majority of their lifetime in Pending.

Completed

The instance reached a Complete node on the canvas. All required steps on the path have been submitted. No further action is needed.

Completed instances are read-only. The full step history, submitted form data, and uploaded files remain accessible indefinitely.

Cancelled

An admin manually cancelled the instance. No new steps will be created or assigned. Cancellation is permanent — a cancelled instance cannot be resumed.

Pending steps that existed at the time of cancellation remain in the history but require no action.

Error

The workflow engine encountered a problem it could not automatically resolve. The most common cause is an assignee resolution failure — the assignee rule for a step could not find a valid user. Examples:

  • "Manager of Requestor" rule: the person who triggered the flow has no manager assigned
  • "Fixed assignee" rule: the designated user has been deactivated
  • "Department head" rule: the target department has no head assigned
  • "Role in department" rule: no active users with the required role exist in the department

When an error occurs, the instance stops progressing. An error event is logged in the activity log with a description of the failure.

What to do when you see an Error status

  1. Open the instance in Admin → Instances
  2. Read the Activity Log — the error event describes which step failed and why
  3. Fix the root cause (assign a manager, reactivate the fixed assignee, assign a department head, etc.)
  4. Re-trigger the flow — a flow in Error cannot be automatically resumed; the requester must start a new instance

Where to check instance statuses

  • My Flows tab (/tasks → My Flows) — instances you triggered
  • Admin → Instances — all instances in your organisation, with a status filter
  • Instance detail panel — click any instance row to see the full history and current status

See also