Skip to main content
A workflow defines what to collect and when. Each execution is a run. Kadoa tracks workflow, run, agent, and support states separately.

States

These diagrams show the common transitions.

Workflow

Active workflows run once, on a schedule, or continuously. An active workflow can be waiting between runs.

Run

When a run hits a problem, Kadoa may investigate it before reporting a failure. The workflow shows Investigating until Kadoa resolves the problem or opens a support case. A monitor shows Investigating the same way while Kadoa looks into its failure. Kadoa combines data quality checks with agent review. Runs that meet the approval requirements pass automatically. Unresolved issues or required human checks go to a Kadoa reviewer before delivery. Previous results stay visible.

Agent activity

When the agent needs input, it is idle and shows Reply needed. Repairs appear as Updating in the UI.

Support

Support is independent of the other states. An open case does not mean a repair is running. While Kadoa is investigating, the workflow shows Investigating instead of In support.

UI states

Badges show each state separately. For example, Preview + Updating + In support means a preview is being updated and a support case is open. Previous data stays visible during updates and after failures. The banner explains the current activity or action needed.

API states

Use presentation to display states and availableActions to enable controls. List and detail responses include: A preview being updated returns:
The API rechecks permissions and state when you submit an action. If a preview no longer reflects the workflow’s current settings, approving it does not activate the workflow. PUT /v4/workflows/{workflowId}/resume starts a new preview run with the current settings and responds with 202 and the new run’s jobId. Approve the new preview once it finishes. Bulk approval through POST /v4/workflows/bulk reports the same case per workflow with previewRestarted: true and the jobId.

Filtering workflows

Filter by dashboard group, displayState, or lifecycle state:
Groups are attention, working, support, failed, active, complete, and paused. Open support cases place workflows in support, unless Kadoa is investigating the workflow: then it is in working with displayState INVESTIGATING. The run history reports a run under investigation as IN_PROGRESS. In the dashboard, workflows you pin appear in a Pinned section above the status groups. Pins are per user and don’t change presentation.group or group filters. You cannot filter by presentation.status.