Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kestra Executions API

Trigger and inspect workflow executions.

Kestra Executions API is one of 7 APIs that Kestra publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Executions. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 4 operations across 4 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: http://localhost:8080, https://{host}.

4 operations 4 paths 3 schemas 3 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Servers
http://localhost:8080
https://{host}
Authentication
HTTP Basic
Contact
License
Resource Areas
1

Authentication & Security 1

Kestra Executions API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — Optional HTTP basic authentication for self-hosted Kestra instances.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Executions 4

Trigger and inspect workflow executions.

GET
/api/v1/executions
Search executions
searchExecutions 5 params → 200
POST
/api/v1/executions/trigger/{namespace}/{flowId}
Trigger a flow execution
triggerExecution 2 params body → 200
GET
/api/v1/executions/{executionId}
Get an execution by ID
getExecution 1 param → 200
GET
/api/v1/executions/{executionId}/logs
Get logs for an execution
getExecutionLogs 2 params → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are Execution (6 properties), LogEntry (4 properties), ExecutionPage (2 properties). Each schema is shown below with its type and property counts.

Execution
object
6 properties
LogEntry
object
4 properties
ExecutionPage
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kestra-executions-api-openapi.yml Raw ↑

Other APIs Kestra publishes across the network.

Kestra Enterprise API
Kestra Files API
Kestra Flows API
Kestra KVStore API
Kestra Namespaces API
Kestra Triggers API