Helm Release Endpoints

The Helm release endpoints manage the lifecycle of Helm chart deployments for tenants, including installation, upgrades, rollbacks, and batch operations. Served by HelmReleaseController at /api/v1/helm/releases.

Endpoints

Method	Endpoint	Description	Role
POST	`/api/v1/helm/releases`	Install a release	Admin
GET	`/api/v1/helm/releases/:releaseId`	Get release by ID	Admin
GET	`/api/v1/helm/releases/tenant/:tenantId`	Get tenant releases	Admin
POST	`/api/v1/helm/releases/:releaseId/upgrade`	Upgrade release	Admin
POST	`/api/v1/helm/releases/:releaseId/rollback`	Rollback to revision	Admin
POST	`.../rollback/last-successful`	Rollback to last successful	Admin
DELETE	`/api/v1/helm/releases/:releaseId`	Uninstall release	Admin
GET	`/api/v1/helm/releases/:releaseId/history`	Get revision history	Admin
GET	`/api/v1/helm/releases/summary`	Get release summary	Platform Admin
GET	`.../chart/:chartName/versions`	Version distribution	Platform Admin
GET	`.../chart/:chartName/needs-upgrade`	Releases needing upgrade	Platform Admin
POST	`.../chart/:chartName/batch-upgrade`	Batch upgrade all releases	Platform Admin

POST /api/v1/helm/releases

Installs a new Helm release for a tenant.

{
  "tenantId": "uuid",
  "releaseName": "acme-query-engine",
  "namespace": "tenant-acme",
  "chartName": "matih-query-engine",
  "chartVersion": "1.2.0",
  "appVersion": "2.0.0",
  "valuesOverride": {
    "replicaCount": 2,
    "resources": { "requests": { "memory": "2Gi" } }
  },
  "description": "Initial query engine deployment",
  "timeout": 600,
  "atomic": true,
  "waitForJobs": true
}

Upgrade

POST /api/v1/helm/releases/:releaseId/upgrade

{
  "chartVersion": "1.3.0",
  "appVersion": "2.1.0",
  "valuesOverride": { "replicaCount": 3 },
  "description": "Scale up for increased load"
}

Rollback

Rollback to a specific revision or to the last successful revision:

POST /api/v1/helm/releases/:releaseId/rollback
{"targetRevision": 3}

POST /api/v1/helm/releases/:releaseId/rollback/last-successful

Batch Operations

Platform administrators can batch-upgrade all releases of a specific chart:

POST /api/v1/helm/releases/chart/matih-query-engine/batch-upgrade?targetVersion=1.3.0

This upgrades all tenant releases of the specified chart to the target version.

Privacy Endpoints Deployment Endpoints