Overview
Manage Tektona resources programmatically with our SDKs.
Tektona ships first-party SDKs that wrap the HTTP API. They handle authentication, request shaping, and typed responses so you can focus on orchestrating sandboxes and agents.
Available SDKs
Python and Go SDKs are not yet shipped. Until they are, generate a client
directly from the OpenAPI spec using
openapi-generator, oapi-codegen, or your tool of choice. The spec is
the same one this site renders, and is meant to produce idiomatic clients.
Prerequisites
To use any Tektona SDK you need:
- A Tektona account with at least one organization and project
- An API key. Create one from the Tektona console (Settings → API Keys).
The TypeScript SDK reads TEKTONA_API_KEY (and optionally TEKTONA_API_URL)
from the environment by default. See the
TypeScript SDK page for details and explicit-config
examples.
How authentication works
API keys are bearer tokens tied to your user. The same key works
across every organization and project you have access to. The SDK sends
them as Authorization: Bearer <key> on every request. Keys do not
auto-rotate, so revoke an old key from the console after creating a
replacement.
For shell workflows, store the key with tektona api-key set instead of
leaving it in shell history.
Package
Published on npm as @tektona/sdk.