Use this API to interact with Helm package clients.

This API is used by the Helm-related package clients such as Helm and helm-push, and is generally not meant for manual consumption.

These endpoints do not adhere to the standard API authentication methods. See the Helm registry documentation for details on which headers and token types are supported. Undocumented authentication methods might be removed in the future.

Upload a chart

POST /api/v4/projects/{id}/packages/helm/api/{channel}/charts

Uploads a specified chart for a project.

Parameters

NameTypeDescription
id
Path, required
Integer or stringThe ID or full path of a project
channel
Path, required
StringHelm channel
Pattern: ^([a-zA-Z0-9](\.|-|_)?){1,255}(?<!\.|-|_)$
Example: stable

Request body (multipart/form-data)

PropertyTypeDescription
chart
Required
String (binary)The chart file to be published (generated by Multipart middleware)

Responses

CodeDescriptionSchema
201Created—
400Bad Request—
401Unauthorized—
403Forbidden—
404Not Found—

Authorize a chart upload from workhorse

POST /api/v4/projects/{id}/packages/helm/api/{channel}/charts/authorize

This feature was introduced in GitLab 14.0

Parameters

NameTypeDescription
id
Path, required
Integer or stringThe ID or full path of a project
channel
Path, required
StringHelm channel
Pattern: ^([a-zA-Z0-9](\.|-|_)?){1,255}(?<!\.|-|_)$
Example: stable

Responses

CodeDescriptionSchema
200OK—
400Bad Request—
401Unauthorized—
403Forbidden—
404Not Found—

Download a chart

GET /api/v4/projects/{id}/packages/helm/{channel}/charts/{file_name}.tgz

Downloads a specified chart for a project.

Parameters

NameTypeDescription
id
Path, required
Integer or stringThe ID or full path of a project
channel
Path, required
StringHelm channel
Pattern: ^([a-zA-Z0-9](\.|-|_)?){1,255}(?<!\.|-|_)$
Example: stable
file_name
Path, required
StringHelm package file name
Example: mychart

Responses

CodeDescriptionSchema
200OKString (binary) (application/octet-stream)
400Bad Request—
401Unauthorized—
403Forbidden—
404Not Found—

Download a chart index

GET /api/v4/projects/{id}/packages/helm/{channel}/index.yaml

Downloads a specified chart index for a project.

Parameters

NameTypeDescription
id
Path, required
Integer or stringThe ID or full path of a project
channel
Path, required
StringHelm channel
Pattern: ^([a-zA-Z0-9](\.|-|_)?){1,255}(?<!\.|-|_)$
Example: stable

Responses

CodeDescriptionSchema
200OK—
400Bad Request—
401Unauthorized—
403Forbidden—
404Not Found—