This endpoint allows submitting external links as media for a release. Links are validated and stored for later processing. Only releases in ‘draft’ or ‘rejected’ status can have links submitted.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/releases/{id}/media/links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"links": [
{
"url": "https://wetransfer.com/downloads/abc123",
"name": "Track Demo",
"type": "audio"
},
{
"url": "https://drive.google.com/file/d/abc123",
"name": "Album Artwork",
"type": "image"
}
]
}'
{
"success": true,
"data": {
"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
}
},
"message": "Media uploaded successfully"
}
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Release ID
Success
The response is of type object
.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/releases/{id}/media/links \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"links": [
{
"url": "https://wetransfer.com/downloads/abc123",
"name": "Track Demo",
"type": "audio"
},
{
"url": "https://drive.google.com/file/d/abc123",
"name": "Album Artwork",
"type": "image"
}
]
}'
{
"success": true,
"data": {
"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
}
},
"message": "Media uploaded successfully"
}