Documentation Index
Fetch the complete documentation index at: https://akua-1dce587a.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Per-installation git repositories
Every installation now gets its own private git repository. Clone it, edit the inputs or composition, push, and Akua rolls out the change. The repository is the same source of truth the dashboard reads from. UI edits and git pushes converge on the same state.Use the new repository to:- Patch any field on any rendered resource without forking the upstream package.
- Add resources the upstream doesn’t include (extra ConfigMaps, sidecars, network policies).
- Roll back to a previous deployment with
git revert. - Pin to a specific upstream version and update on your schedule.
Repositories REST API
New/v1/repositories endpoints let you list and inspect installation repositories programmatically. Each entry includes the clone URL, the latest deployed commit, and a content hash that lets you skip redundant deploys when nothing changed. See the Repositories API reference.Read-only access tokens
Tokens minted for read-only consumers (deployment systems, CI artifacts) are now physically scoped to fetch operations on the platform side. A leaked read token cannot be used to push, regardless of how it gets misused.Packages API
New/v1/packages endpoints expose the Package definitions backing your products, including the typed input schema served at /v1/packages/{id}/versions/{semver}/inputs. Use them to drive your own install flows, generate type-safe client SDKs, or audit which Package version every product points at. See the Packages API reference.AI and Agents: Platform MCP with Code Mode
AI agents can now manage Akua infrastructure through the Model Context Protocol. The new platform MCP server atakua.dev/mcp uses Code Mode. Instead of one tool per API endpoint, agents get two tools (search + execute) and write JavaScript to compose API calls in a sandboxed V8 isolate. Inspired by CodeAct research and powered by the open-source cnap-tech/codemode library.Public REST API
Full RESTful API atapi.akua.dev/v1 for managing workspaces, clusters, packages, products, installations, and repositories programmatically. Supports workspace-owned API tokens and JWT authentication. A workspace API token implies its workspace, so most calls need no workspace header; broad credentials select the workspace with the optional Akua-Context header. Powers both the CLI and the platform MCP server.Cloudflare Tunnel Preview Domains
Instant*.cnap.app HTTPS URLs for every app, with no DNS setup or Cloudflare account required. Also supports custom domains using your own Cloudflare credentials, managed per-workspace in Settings.