Skip to main content
Tasks represent individual units of work within a workflow execution. When a workflow runs, each step in the task graph becomes a task with its own status. External workers or services can update task statuses to report progress, signal completion, or indicate failure.

​
What tasks are

A task corresponds to a single node in the workflow DAG. Each task has a status (e.g., pending, running, completed, failed) that reflects the current state of that step. As the workflow progresses, tasks transition through these states.

​
Updating task statuses

You can update task statuses programmatically to integrate external workers or services with CDF workflows. Use the API to mark tasks as in progress, completed, or failed. This allows you to orchestrate long-running or distributed work across your systems.
Task status updates are typically performed by workflow workers or automation services that execute the actual work defined by each task.

​
Key operations

  • Update status: Report progress, completion, or failure for a task.
  • Retrieve tasks: List or get tasks associated with a workflow execution.
  • Filter by status: Find tasks in a specific state (e.g., pending, running, failed).
You use tasks to coordinate multi-step workflows and ensure that each step’s outcome is properly tracked in CDF.
Last modified on April 23, 2026