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.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/releases/{id}/tracks/link-asset \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"assetId": "550e8400-e29b-41d4-a716-446655440000",
"trackNumber": 2,
"overrides": {
"title": "My Song (Radio Edit)",
"explicit": "clean"
}
}'
{
"success": true,
"message": "Asset \"My Song\" linked to release successfully",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"TenantId": 123,
"ReleaseId": "660e8400-e29b-41d4-a716-446655441111",
"assetId": "770e8400-e29b-41d4-a716-446655442222",
"trackNumber": 1,
"title": "My Track Title",
"version": "Radio Edit",
"isrc": "USABC1234567",
"iswc": "T-123456789-0",
"duration": 213.5,
"lyrics": "Verse 1\nChorus\nVerse 2",
"language": "en",
"displayArtist": "Artist Name",
"artists": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"artistName": "John Doe",
"type": "primary"
},
{
"id": "660e8400-e29b-41d4-a716-446655441111",
"artistName": "Jane Smith",
"type": "featuring"
}
],
"mainGenre": [
"Pop",
"Rock"
],
"subGenre": [
"Alternative"
],
"contributors": {
"producer": [
"Producer Name"
],
"songwriter": [
"Writer Name"
]
},
"media": [
{
"cloudId": "550e8400-e29b-41d4-a716-446655440000",
"cloudUrl": "https://storage.royalti.io/files/audio.mp3",
"type": "audio",
"name": "my-track.mp3",
"isLink": false,
"releasePath": "tenant123/releases/release456/tracks/track789/file.mp3",
"metadata": {
"duration": 213.5,
"bitrate": "320",
"sampleRate": "44100",
"channels": "2",
"codec": "mp3",
"fileSize": 1048576,
"mimeType": "audio/mpeg",
"processedAt": "2023-11-07T05:31:56Z",
"linkValidated": true
}
}
],
"metadata": {
"bpm": 120,
"key": "C Major"
},
"explicit": false
}
}
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Release ID
Asset linked successfully
The response is of type object
.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/releases/{id}/tracks/link-asset \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"assetId": "550e8400-e29b-41d4-a716-446655440000",
"trackNumber": 2,
"overrides": {
"title": "My Song (Radio Edit)",
"explicit": "clean"
}
}'
{
"success": true,
"message": "Asset \"My Song\" linked to release successfully",
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"TenantId": 123,
"ReleaseId": "660e8400-e29b-41d4-a716-446655441111",
"assetId": "770e8400-e29b-41d4-a716-446655442222",
"trackNumber": 1,
"title": "My Track Title",
"version": "Radio Edit",
"isrc": "USABC1234567",
"iswc": "T-123456789-0",
"duration": 213.5,
"lyrics": "Verse 1\nChorus\nVerse 2",
"language": "en",
"displayArtist": "Artist Name",
"artists": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"artistName": "John Doe",
"type": "primary"
},
{
"id": "660e8400-e29b-41d4-a716-446655441111",
"artistName": "Jane Smith",
"type": "featuring"
}
],
"mainGenre": [
"Pop",
"Rock"
],
"subGenre": [
"Alternative"
],
"contributors": {
"producer": [
"Producer Name"
],
"songwriter": [
"Writer Name"
]
},
"media": [
{
"cloudId": "550e8400-e29b-41d4-a716-446655440000",
"cloudUrl": "https://storage.royalti.io/files/audio.mp3",
"type": "audio",
"name": "my-track.mp3",
"isLink": false,
"releasePath": "tenant123/releases/release456/tracks/track789/file.mp3",
"metadata": {
"duration": 213.5,
"bitrate": "320",
"sampleRate": "44100",
"channels": "2",
"codec": "mp3",
"fileSize": 1048576,
"mimeType": "audio/mpeg",
"processedAt": "2023-11-07T05:31:56Z",
"linkValidated": true
}
}
],
"metadata": {
"bpm": 120,
"key": "C Major"
},
"explicit": false
}
}