Skip to main content

Workflow and Task Status

The workflow and task statuses are crucial to understanding the execution mechanism in Conductor. You can check a workflow execution’s current status and task status from the Conductor UI or using API.

Workflow status

Once started, a workflow execution will either be in an ongoing or terminal status.

StatusDescription
RUNNINGThe workflow is in progress.
PAUSEDThe workflow is paused by a user or external event, and is waiting for a manual action to resume.
COMPLETEDTerminal status where all the tasks in the workflow are completed.
TIMED_OUTTerminal status where one of the workflow tasks has timed out.
TERMINATEDTerminal status where an incomplete workflow has been terminated by a user, event, or another workflow.
FAILEDTerminal status where the workflow has encountered an error and failed. You can retry the workflow execution from the failed task.

Task state transitions

During a workflow execution, each task will go through the state transitions illustrated in the figure below. These states roughly correspond to the nine task statuses in Conductor.

Task state transitions in Conductor.

Task status

Each task will be in a scheduled, ongoing, or terminal status.

StatusDescription
SCHEDULEDThe task has been scheduled to be picked up by a worker.
IN_PROGRESSThe task is being executed by a worker.
SKIPPEDThe task is skipped without executing, and the workflow continues to the subsequent tasks.

Occurs if the Skip Task API is used during a currently running workflow.
TIMED_OUTThe task times out without being completed.

Occurs if the task has been configured with the following timeout parameters in its task definition:
  • timeOutPolicy.
  • timeOutSeconds
  • pollTimeoutSeconds
  • responseTimeoutSeconds
CANCELEDThe scheduled task has been canceled without being completed because the workflow has been terminated.
FAILEDThe task failed to complete due to an error, and the workflow can be retried from the failed task.
FAILED_WITH_TERMINAL_ERRORThe task failed to complete due to an error and cannot be retried.
COMPLETED_WITH_ERRORSThe task encountered some errors but is completed.

Occurs due to a variety of reasons. For example, if a task is set as optional and fails during execution.
COMPLETEDThe task has been successfully completed without any errors.