Create Release

Create Release. Use it to draft releases, update metadata, attach artwork and tracks, define rights, choose territories, and prepare releases for review and delivery. It applies the requested change and returns the updated resource, validation result, or action status needed for the next API step.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Header Parameters

X-User-Id*string

Required user_id for catalog ownership and quota context. The client must also have users:act-as.

Formatuuid

Request Body

multipart/form-data

Multipart request payload.

TypeScript Definitions

Use the request body type in TypeScript.

title*string

Catalog or content title shown in the dashboard and API responses.

cover_art*file

Binary cover-art image file. Use JPG or PNG artwork that meets store artwork requirements.

Formatbinary

label?string

Label name attached to the release metadata.

copyright_material?boolean

Whether the submitter has indicated that copyright-sensitive material is present.

copyright_links?array<>

Supporting URLs for rights review when copyright material is declared.

upc?string

UPC supplied for the release, or omitted when one should be assigned later.

reference?string

Human-readable catalog or billing reference shown in the dashboard.

remix_version?string

Version label such as Original Mix, Radio Edit, or Remix.

genre?string

Primary release or track genre selected from supported values.

secondary_genre?string

Optional secondary genre used for more precise metadata.

language?string

Primary language value used for profile, release, or track metadata.

explicit_content?boolean

Whether the release or track is marked as explicit.

format*string

Release format, such as single, EP, or album.

description?string

Human-readable description for this record or workflow.

artists*array<>

Artists credited or attached to this catalog record.

[key: string]?any

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/releases" \  -H "X-User-Id: 43cda1b2-f7e9-49c7-b4fb-4fcfc5a02a9c" \  -F title="Midnight Atlas" \  -F cover_art="midnight-atlas-cover.jpg" \  -F label="Night Shift Records" \  -F copyright_material="false" \  -F copyright_links="[]" \  -F upc="5054429191012" \  -F reference="NSD-2026-041" \  -F remix_version="" \  -F genre="Electronic" \  -F secondary_genre="Ambient" \  -F language="English" \  -F explicit_content="false" \  -F format="single" \  -F description="A late-night electronic single built for DSP delivery." \  -F artists="[    {      \"artist_id\": \"6f209ac7-d82c-4c8f-9d3e-bfe39c0df802\",      \"type\": \"Primary Artist\"    }  ]"

{  "success": true,  "message": "Release created.",  "data": {    "release_id": "b7a15d95-58f6-4f67-b5d1-89f4f5bfb4d8",    "title": "Midnight Atlas",    "status": "draft",    "format": "single",    "label": "Night Shift Records",    "genre": "Electronic",    "secondary_genre": "Ambient",    "language": "English",    "explicit_content": false,    "upc_code": "5054429191012",    "reference_number": "NSD-2026-041",    "scheduled_date": "2026-08-21",    "original_release_date": "2026-08-21",    "copyright_detection_enabled": true,    "price_category": "mid",    "territories": [      "GB",      "US",      "DE",      "NL"    ],    "distribution": [      {        "channel": "spotify",        "status": "selected"      },      {        "channel": "apple_music",        "status": "selected"      },      {        "channel": "youtube_music",        "status": "selected"      }    ],    "cover_art": "https://assets.spacemedia-docs.invalid/releases/midnight-atlas/cover.jpg",    "track_count": 0,    "artists": [      {        "artist_id": "6f209ac7-d82c-4c8f-9d3e-bfe39c0df802",        "name": "Nova Vale",        "type": "Primary Artist"      }    ],    "created_by": {      "user_id": "7d2d9f72-c0a2-4d4b-9b6d-7caa942b8a71",      "name": "Maya Chen",      "email": "maya.chen@northstar-distribution.co.uk"    },    "created_at": "2026-07-04T09:30:00+00:00",    "updated_at": "2026-07-04T10:15:00+00:00"  }}

Authorization

Header Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`