Observability

Task Executions

Every workflow run creates a task. Track status, inspect step results, filter by workflow, and manage execution history.

What is a Task?

A Task is the runtime instance of a workflow execution. It contains the execution context, step results, status, and metadata. Tasks are created by manual runs, schedules, webhooks, or public API calls.

Execution Record

Tasks capture the full lifecycle: pending, running, completed, failed, pending_approval, or rejected.

Filtering & Search

Filter tasks by workflow, search by name or ID, and paginate through execution history.

Step Detail

Drill into a task to see every step's input, output, duration, status, and error details.

Task Lifecycle

  1. Pending — Task is created and queued for execution.
  2. Running — A worker has claimed the task and is executing steps.
  3. Pending Approval — Execution is paused at an approval node.
  4. Completed — All steps finished successfully.
  5. Failed / Rejected — Execution ended due to an error or human rejection.

Task API

POST/api/tasks

Create a new task. Optionally link it to a workflow.

GET/api/tasks

List tasks for the authenticated user with pagination.

GET/api/tasks/:id

Get task details including step results and metadata.

DELETE/api/tasks/:id

Permanently delete a task and its associated step results.

UI Features

  • Task list supports workflow filtering, search, and pagination.
  • Task detail view shows step logs, variables, metadata, replay controls, and API settings.
  • Approval tasks show an inline action to approve or reject directly from the task list.