POST /releases
This endpoint allows the creation of a new release with tracks. The release will be created in draft status and can be submitted for review once ready.Request Body
- title (string, required): The title of the release
- displayArtist (string, required): The display artist name
- artists (object, required): Artists and their roles (must include at least one primary artist)
- format (string): Format of the release (Single, EP, Album, etc.)
- type (string): Type of release (Audio, Video, Mixed)
- version (string): Version of the release
- label (string): Record label
- copyright (string): Copyright information
- mainGenre (array): Main genres
- subGenre (array): Sub-genres
- contributors (object): Contributors and their roles
- description (string): Description of the release
- metadata (object): Additional metadata
- explicit (string): Content rating: ‘explicit’, ‘clean’, or null
- releaseDate (string): Release date
- preReleaseDate (string): Pre-release date
- tracks (array, required): Array of tracks
Authentication
This endpoint requires authentication. Include your bearer token in the Authorization header.Request Body
Example Request
Request Schema
Field | Type | Required | Description |
---|---|---|---|
title | string | ✅ | The title of the release |
displayArtist | string | ✅ | The display artist name |
artists | object | ✅ | Artists and their roles (must include at least one primary artist) |
format | string | ❌ | Format of the release |
type | string | ❌ | Type of release |
version | string | ❌ | Version of the release |
label | string | ❌ | Record label |
copyright | string | ❌ | Copyright information |
mainGenre | array | ❌ | Main genres of the release |
subGenre | array | ❌ | Sub-genres of the release |
contributors | object | ❌ | Contributors and their roles |
description | string | ❌ | Description of the release |
metadata | object | ❌ | Additional metadata |
explicit | string | ❌ | Content rating: explicit, clean, or null (not specified) |
ownerId | string | ❌ | Optional: UUID of the user who will own the release (admin/owner only) |
releaseDate | string | ❌ | Release date |
preReleaseDate | string | ❌ | Pre-release date |
tracks | array | ✅ | Array of tracks in the release |
Responses
✅ 201 - Success - Release created
⚠️ 400 - Bad Request - Validation error
⚠️ 401 - Unauthorized
❌ 500 - Internal Server Error
Tags
Release
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Body
The title of the release
The display artist name
Artists and their roles (must include at least one primary artist)
Array of tracks in the release
Format of the release
Single
, EP
, Album
, Compilation
, Soundtrack
, Live
, Remix
, Remaster
Type of release
Audio
, Video
, Mixed
Version of the release
Record label
Copyright information
Main genres of the release
Sub-genres of the release
Contributors and their roles
Description of the release
Additional metadata
Content rating: explicit, clean, or null (not specified)
explicit
, clean
Optional: UUID of the user who will own the release (admin/owner only)
"550e8400-e29b-41d4-a716-446655440000"
Release date
Pre-release date