Execute Scripts, API Calls, and Queries with Runnable Tasks

Table of Contents
For the complete documentation index, see llms.txt. For a full content snapshot, see llms-full.txt. Append .md to any kestra.io/docs/* URL for plain Markdown.

Runnable tasks perform the actual work in a flow — file system operations, API calls, database queries, and scripts — executed by distributed workers.

Each task requires an id and a type, defined by its fully qualified Java class name. Refer to each task’s plugin documentation for a full list of available properties.

Most tasks are runnable. The exception is Flowable tasks, which control orchestration logic and run on the executor rather than workers.

By default, Kestra includes only a few runnable tasks. Many more are available as plugins, and the default Docker image comes preloaded with several of them.

Example

The following example shows two runnable tasks: one that makes an HTTP request and another that logs its output.

id: runnable_http
namespace: company.team


tasks:
  - id: make_request
    type: io.kestra.plugin.core.http.Request
    uri: https://kestra.io/api/mock
    method: GET
    contentType: application/json


  - id: print_status
    type: io.kestra.plugin.core.log.Log
    message: "{{ outputs.make_request.body }}"

Was this page helpful?