Skip to main content
POST
/
releases
/
{id}
/
media
/
links
Submit Media Links to Release
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"
}

POST /releases//media/links

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.

Authentication

This endpoint requires authentication. Include your bearer token in the Authorization header.

Path Parameters

ParameterTypeInRequiredDescription
idstringpathRelease ID

Request Body

Responses

✅ 201 - Success

⚠️ 400 - undefined

⚠️ 401 - undefined

⚠️ 404 - undefined

❌ 500 - undefined

Tags

Release Media

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

Response

Success

success
boolean
Example:

true

data
message
string
Example:

"Media uploaded successfully"

I