---
title: "Create a new release (draft)"
method: POST
path: "/v1/releases"
tags: ["releases"]
---

# Create a new release (draft)

`POST /v1/releases`

## Request

- Base URL: `https://api.ditto.audio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ditto.audio/v1/releases`
- Auth: HTTP bearer

## Request body

- CreateReleaseDto
  - `version` string, required: Semver version string
  - `productId` string
  - `channel` 'stable' | 'beta' | 'alpha'
  - `releaseNotes` string: Markdown release notes
  - `minVersion` string: Minimum version required to update directly to this release
  - `isMandatory` boolean: Force clients to update (critical fix)

## Response `201`

---

[API](https://skmtc.dev/ditto/apis/ditto-audio-api.md) · [All operations](https://skmtc.dev/ditto/apis/ditto-audio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ditto/apis/ditto-audio-api/revisions/30c8d7c218da?raw)