Skip to content
Back to

Exception management

When a validation or transform fails, you choose whether the run records a normal audit error or a durable exception you can triage later. Exceptions are distinct from canvas audit Warnings and Errors: they persist on the workflow in Convex and appear on the Exception Management view (?view=exceptions).

On error configuration

Section titled “On error configuration”

On an operation badge (and on node execution settings) you set On error:

  • raise error - existing audit error path for the run
  • raise exception - writes an audit row with reserved type exception, then the workflow engine syncs that row into workflow_exceptions when the run finishes

You also set exception type (label), message, and severity (info, warning, or error). The default exception type for an operation is {action} {type} issue (for example arrayLengthLessThan validation issue). For a node without an operation context, the default is {nodeType} issue.

Exception Management board

Section titled “Exception Management board”

Open the workflow Exception Management tab (View → Exceptions) to triage persisted exceptions for that workflow. Switch between board (Kanban) and grid (VirtualDataGrid with View / Resolve / Sign off actions, node badges, and operation badges). The exception detail Overview uses the same badges and Resolve / Sign off actions. The Exceptions view icon shows a count pill for open exceptions and uses the colour of the worst open severity.

You can move items through lifecycle statuses such as Open, resolved, and signed-off. The board shows workflow-scoped exceptions, not only the current run’s live audit stream.

Section titled “Related”