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
Usepresentation to display states and availableActions to enable controls. List and detail responses include:
A preview being updated returns:
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:
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.