Visual workflows

Inspect workflow runs and diagnose failures

Workflow run history is the record of executions and their outcomes. It connects a configured process with evidence of what actually happened.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Find the execution before changing the process

When an expected output is missing, first locate the relevant run. Distinguish a workflow that never started from one that started and failed or was skipped by a filter. Editing action settings will not fix a disabled workflow, and changing a schedule will not fix an invalid recipient.

Compare the run with the input and settings active at that time. If you changed a field or connection after the failure, do not assume that the old run used the new values. Successful runs are kept for 14 days and failed runs for 30 days.

Investigate a failed run

  1. Open Workflows, look for a workflow marked Failing, and open its Run History tab.
  2. Filter runs by Sent, Failed, or Skipped and find the run for the expected record or time.
  3. Expand it to read the Record, When, Error, and Body details, and use View node to open the step that failed.
  4. Check the actual destination for partial output before deciding to retry.
  5. Correct the setting or connection, then use Retry, which runs it again as a new run, and verify the result.

Separate common failure categories

Run diagnosis
ObservationInvestigation
No matching runTrigger, enabled state, required fields, and schedule
Skipped runThe filter conditions and the record values
Connection failureSelected email connection and its current credential
Reported success but wrong outputBusiness intent, substitutions, and destination
Partial outputCompleted effects before any retry

Retry without duplicating completed work

A failed sequence may already have completed an earlier action. Review existing records or messages before retrying. Do not assume that failure means nothing happened or that a retry deduplicates every external effect.

For support, capture the installed version, workflow purpose, a redacted error, and the step where the failure appeared. Remove message contents, credentials, and private record values unless they are necessary and can be shared safely. A precise description of expected versus observed output is more useful than a large unsorted log.

Version and sources

This guide describes the Kition desktop app as of source 7d49036f, checked on 2026-11-06. Connected actions also depend on the configured model provider or service. If your installed version is older, some controls may differ.

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.