---
title: "Create a Helm deployment"
method: POST
path: "/api/v1/orgs/{orgId}/clusters/{id}/deployments"
tags: ["deployments"]
---

# Create a Helm deployment

`POST /api/v1/orgs/{orgId}/clusters/{id}/deployments`

Creating a Helm deployment

## Path parameters

- `orgId` integer, required
- `id` integer, required

## Request body

- CreateUpdateDeploymentRequest
  - `name` string, required
  - `version` string — Version of the deployment. If not specified, the latest version is used.
  - `package` string, byte — The chart content packaged by `helm package`. If specified chart version is ignored.
  - `namespace` string
  - `releaseName` string
  - `dryRun` boolean
  - `wait` boolean — if set, will wait until all Pods, PVCs, Services, and minimum number of Pods of a Deployment are in a ready state before marking the release as successful
  - `timeout` integer — time in seconds to wait for any individual Kubernetes operation (default 300)
  - `odPcts` object — Map of resources in the template where replicas should have a minimum on-demand percentage. Format: <kind.resourceName: min-percentage>
  - `reuseValues` boolean
  - `values` object — current values of the deployment

## Response `201`

Deployment created successfully

- CreateUpdateDeploymentResponse
  - `releaseName` string
  - `notes` string, base64 — deployment notes in base64 encoded format

## Other responses

- `default` — Internal server error

---

[API](https://skmtc.net/banzaicloud/apis/pipeline-api.md) · [All operations](https://skmtc.net/banzaicloud/apis/pipeline-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banzaicloud/pipeline-api/versions/a2e35c430378/schema)