Workflow Components

Get to know the main orchestration components of a Kestra workflow.

Flow

Flow

Flow is a container for tasks and their orchestration logic.

Namespace

Namespace

Namespaces are a logical groupings of flows and their components.

Execution

Execution

Execute flows and view the results.

Variables

Variables

Variables are key–value pairs that let you reuse values across tasks.

Inputs

Inputs

Inputs are dynamic values passed to the flow at runtime.

Outputs

Outputs

Outputs let you pass data between tasks and flows.

Labels

Labels

Labels are key-value pairs in Kestra that let you organize [flows](./01.flow.md) and [executions](./03.execution.md) across multiple dimensions, without being restricted to a single hierarchy.

Plugin Defaults

Plugin Defaults

Plugin defaults are default values applied to every task of a given type within one or more flows.

Subflows

Subflows

Subflows let you build **modular** and **reusable** workflow components.

Errors

Errors

Kestra provides multiple ways to handle errors, helping you both identify issues and decide whether your flows should stop or continue running after an error.

Retries

Retries

Retries handle transient failures in your workflows.

Task timeout

Task timeout

A timeout defines the maximum duration a [runnable task](./01.tasks/01.runnable-tasks.md) is allowed to run.

Concurrency Limits

Concurrency Limits

Control how many executions of a flow can run at the same time.

Descriptions

Descriptions

You can document flows, inputs, outputs, tasks, and triggers by adding a `description` property.

Disabled flag

Disabled flag

The `disabled` flag is a boolean property that lets you skip a flow, task, or trigger.

States

States

States control the status of your workflow execution.

SLA

SLA

Assert that your workflows meet SLAs.

Finally

Finally

Define a block of tasks that always run at the end of a flow, regardless of task status.

afterExecution

afterExecution

Run tasks after a flow execution completes.

Task Cache

Task Cache

Cache the status and outputs of computationally expensive operations.