# Release Notes

The Crypto Vault publishes two release streams, because different teams consume different parts of the product.

## API releases

[API releases](/releases/api) track the customer-facing REST interface described by the OpenAPI spec: endpoints, authentication, request and response schemas, error shapes, pagination, and externally visible behavior. Use these notes when you build or update an integration.

The full API specification for each release is available in the [API Reference](/api-reference).

## Helm chart releases

[Helm chart releases](/releases/helm) track the deployable bundle consumed by infrastructure teams. Each chart version pins exact images for all services, chart dependencies, supported values, migration gates, and install or upgrade assumptions.

Use these notes when you install or upgrade the vault, change chart values, or review operational changes. Image tags are pinned by the chart version. Do not override per-service tags.

## How the streams relate

A Helm chart release may keep the same API release if it only changes deployment behavior, chart values, service images, or operational assumptions. An API release describes the interface your integration sees; a Helm chart release describes the artifact your infrastructure team deploys.

See [Upgrades and monitoring](/deploy/operations/upgrades-monitoring) for the Helm upgrade procedure.