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 Files API

Manage namespace files.

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

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

This API exposes 3 operations across 2 paths, and defines 1 schema. 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}.

3 operations 2 paths 1 schemas 2 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 Files 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 3

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

Files 3

Manage namespace files.

GET
/api/v1/namespaces/{namespace}/files
List namespace files
listNamespaceFiles 2 params → 200
GET
/api/v1/namespaces/{namespace}/files/file
Download a namespace file
downloadNamespaceFile 2 params → 200
POST
/api/v1/namespaces/{namespace}/files/file
Upload a namespace file
uploadNamespaceFile 2 params body → 204

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is NamespaceFile (4 properties). Each schema is shown below with its type and property counts.

NamespaceFile
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kestra-files-api-openapi.yml Raw ↑

Other APIs Kestra publishes across the network.

Kestra Enterprise API
Kestra Executions API
Kestra Flows API
Kestra KVStore API
Kestra Namespaces API
Kestra Triggers API