Skip to main content
POST
Link Existing Asset to Release
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

This endpoint allows linking an existing Asset to a release as a new track. The Asset’s data will be used as defaults, which can be overridden with the overrides parameter. Only releases in ‘draft’ or ‘rejected’ status can have Assets linked. Authorization:
  • Required role: user or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

Release ID

Body

application/json
assetId
string<uuid>
required

UUID of the existing Asset to link

Example:

"550e8400-e29b-41d4-a716-446655440000"

trackNumber
integer

Optional specific track number (if not provided, will use next available)

Required range: x >= 1
Example:

2

overrides
object

Optional fields to override from the Asset's data

Example:

Response

Asset linked successfully

success
boolean
Example:

true

message
string
Example:

"Asset \"My Song\" linked to release successfully"

data
object