Skip to main content

Endpoint Index

This index covers non-resource routes registered by the current backend. Paths are relative to /api/v1; protected routes require a bearer token and RBAC.

Account and Identity

MethodPathDescription
GET/users/meCurrent user
PUT/users/me/passwordChange own password
POST/auth/2fa/setupStart TOTP setup
POST/auth/2fa/enableEnable TOTP
POST/auth/2fa/disableDisable TOTP
POST/auth/public-key/register/beginBegin passkey registration
POST/auth/public-key/register/finishFinish passkey registration
GET/auth/public-key/credentialsList own credentials
PUT/auth/public-key/credentials/:idRename a credential
DELETE/auth/public-key/credentials/:idRevoke a credential

Public login, OAuth, refresh, and public-key login routes are documented in Authentication.

Administration

MethodPathDescription
GET, POST/usersList or create users
GET, PUT, DELETE/users/:idRead, update, or delete a user
PUT/users/:id/reset-passwordReset a password
DELETE/users/:id/public-key-credentials/:credentialIdRevoke a user's credential
GET, PUT/directory/configRead or update directory settings
POST/directory/testTest directory connectivity/settings
POST/directory/previewPreview group-to-role mapping
GET/audit-logsQuery audit events
GET/terminal-sessionsList recorded terminal sessions
GET/terminal-sessions/:idSession metadata
GET/terminal-sessions/:id/playReplay data

Clusters and Packages

MethodPathDescription
GET, POST/clustersList or add clusters
GET, DELETE/clusters/:idRead or remove a cluster
GET/clusters/:id/package-releasesList Helm releases
GET/clusters/:id/package-releases/:namespace/:nameRelease details
GET/clusters/:id/package-releases/:namespace/:name/historyRevision history
POST/clusters/:id/package-releases/preview/:operationDry-run an install or upgrade and issue a confirmation token
POST/clusters/:id/package-releases/installInstall the exact request approved by a preview
POST/clusters/:id/package-releases/upgradeUpgrade the exact request approved by a preview
POST/clusters/:id/package-releases/:namespace/:name/check-upgradeCheck the tracked or supplied indexed Helm source for a newer stable chart version
POST/clusters/:id/package-releases/:namespace/:name/rollbackRoll back
DELETE/clusters/:id/package-releases/:namespace/:nameRemove release
GET, POST/clusters/:id/helm/repositoriesList or create managed Helm/OCI repositories
PUT, DELETE/clusters/:id/helm/repositories/:repositoryIdUpdate or delete a managed repository
POST/clusters/:id/helm/repositories/:repositoryId/testTest a managed repository connection
GET/clusters/:id/helm/repositories/:repositoryId/chartsBrowse an indexed Helm repository
GET/clusters/:id/helm/artifact-hub/searchSearch public charts on Artifact Hub
POST/clusters/:id/helm/charts/inspectInspect chart metadata and contents
POST/clusters/:id/helm/charts/uploadUpload a temporary packaged chart
GET, POST/clusters/:id/helm/upgrade-policiesList or create automatic upgrade policies
PUT, DELETE/clusters/:id/helm/upgrade-policies/:policyIdUpdate or delete an upgrade policy
POST/clusters/:id/helm/upgrade-policies/:policyId/checkRun an upgrade policy immediately
GET/registry-tagsDiscover image tags

Install and upgrade requests use the same body as preview and must include the one-time confirmationToken returned by that preview. The token is bound to the user, cluster, namespace, release, chart source, values, and operation. The upgrade-check body may be empty when the release has a tracked source, or may contain {"source":{"chart":"name","repoUrl":"https://..."}} to verify and associate an indexed repository with an older release. Release source records contain chart coordinates only, never repository credentials. Repository management, private credentials, and upgrade policies require an administrator. Chart uploads use multipart/form-data, expire after 30 minutes, and are bound to the uploading user.

AI, Plugins, and Automation

MethodPathDescription
GET, PUT/ai/configRead or update AI configuration
POST/ai/modelsQuery models from a configured provider
POST/ai/chatStream an assistant response using SSE
POST/ai/continue-actionContinue a confirmed tool action
GET/pluginsList built-in plugins
GET, PUT/plugins/:nameRead or update plugin configuration
GET/plugins/:name/healthCheck plugin health
GET/plugins/prometheus/queryRun a bounded instant PromQL query
GET/plugins/grafana/dashboardsList Grafana dashboards
GET/plugins/argocd/applicationsList Argo CD applications
GET, POST/webhooksList or create webhooks
PUT, DELETE/webhooks/:idUpdate or delete a webhook
POST/webhooks/:id/testSend a test event

Favorites (/favorites) and saved templates (/templates) also expose their standard list/create/delete routes. See the corresponding user guides for UI workflows and RBAC behavior.

Kubernetes HTTP Access

GET and HEAD requests to /clusters/:id/namespaces/:namespace/http/:kind/:name/*path proxy a bounded, resource-authorized request to a Pod or Service. It is not a general-purpose URL proxy; see Extended Access.