> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.royalti.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Submit Media Links to Release
> ### POST /releases/{id}/media/links
This endpoint requires authentication. Include your Bearer token in the Authorization header.
## Description
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.
## Code Examples
```javascript Node.js theme={null}
const response = await fetch('https://api.royalti.io/releases/example-id/media/links', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"ref": "#/components/schemas/LinkSubmissionRequest"
})
});
const data = await response.json();
console.log(data);
```
```python Python theme={null}
import requests
response = requests.post(
'https://api.royalti.io/releases/example-id/media/links',
headers={
'Authorization': f'Bearer {token}'
},
json={"ref":"#/components/schemas/LinkSubmissionRequest"}
)
data = response.json()
print(data)
```
```bash cURL theme={null}
curl -X POST https://api.royalti.io/releases/example-id/media/links \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ref":"#/components/schemas/LinkSubmissionRequest"}'
```
## OpenAPI
````yaml post /releases/{id}/media/links
openapi: 3.0.0
info:
title: Royalti.io API
description: "# Royalti API\r\n\r\nThis is the Royalti music royalty management platform API server.\r\n\r\n## Overview\r\n\r\nThe Royalti API provides comprehensive music royalty management services including:\r\n- Music publishing and writer management\r\n- Royalty processing and analytics\r\n- DDEX integration for music industry standards\r\n- File processing and pattern recognition\r\n- Payment processing and distribution\r\n\r\n## Authentication\r\n\r\nThe API uses JWT-based authentication with multiple protection levels:\r\n- Public endpoints for basic operations\r\n- Protected endpoints requiring valid JWT tokens\r\n- Admin endpoints for administrative functions\r\n\r\n## Features\r\n\r\n- Multi-dimensional royalty analytics\r\n- CWR (Collective Works Registration) support\r\n- DDEX integration for music metadata\r\n- Advanced file processing with pattern recognition\r\n- Real-time data processing with queue system"
version: 2.6.0
contact:
name: Royalti.io Support
email: support@royalti.io
url: https://royalti.io
license:
name: Proprietary
url: https://royalti.io/terms
servers:
- url: https://api.royalti.io
description: Production server
- url: https://api-dev.royalti.io
description: Development server
- url: http://localhost:8084
description: Local development
security:
- bearerAuth: []
tags:
- name: Accounting
description: Accounting and financial transaction operations
- name: DDEX
description: DDEX operations (ERN/MEAD, messages, delivery, providers)
- name: Label
description: Label management operations
- name: Internal Webhooks
description: Internal system webhooks for royalty processing and downloads
- name: Payment Webhooks
description: Payment processor webhook endpoints
- name: Billing Webhooks
description: Stripe billing and subscription webhooks
- name: Infrastructure Webhooks
description: Cloudflare domain and SSL webhooks
- name: Distribution Webhooks
description: Digital distribution platform webhooks (FUGA)
paths:
/releases/{id}/media/links:
post:
tags:
- Release Media
summary: Submit Media Links to Release
description: >-
### POST /releases/{id}/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.
parameters:
- name: id
in: path
required: true
description: Release ID
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/LinkSubmissionRequest'
responses:
'201':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/MediaUploadResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalServerError'
security:
- bearerAuth: []
components:
schemas:
LinkSubmissionRequest:
type: object
properties:
links:
type: array
items:
type: object
properties:
url:
type: string
format: uri
description: The URL to submit
example: https://wetransfer.com/downloads/abc123
name:
type: string
description: Optional name for the link
example: My Track Demo
type:
type: string
enum:
- audio
- video
- image
- document
description: Type of media at the link
example: audio
required:
- url
required:
- links
example:
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
MediaUploadResponse:
type: object
properties:
success:
type: boolean
example: true
data:
oneOf:
- $ref: '#/components/schemas/Media'
- type: array
items:
$ref: '#/components/schemas/Media'
message:
type: string
example: Media uploaded successfully
Media:
type: object
properties:
cloudId:
type: string
description: Cloud storage file ID or unique identifier for links
example: 550e8400-e29b-41d4-a716-446655440000
cloudUrl:
type: string
format: uri
description: Public URL from cloud storage OR the submitted link URL
example: https://storage.royalti.io/files/audio.mp3
type:
type: string
enum:
- audio
- video
- image
- document
description: File type
example: audio
name:
type: string
description: File name or link title
example: my-track.mp3
isLink:
type: boolean
description: Flag to distinguish links from files
example: false
releasePath:
type: string
description: Temporary release storage path (for files only)
nullable: true
example: tenant123/releases/release456/tracks/track789/file.mp3
metadata:
type: object
description: Additional metadata
properties:
duration:
type: number
format: float
description: Duration in seconds
example: 213.5
bitrate:
type: string
description: Audio bitrate
example: '320'
sampleRate:
type: string
description: Audio sample rate
example: '44100'
channels:
type: string
description: Audio channels
example: '2'
codec:
type: string
description: Audio/video codec
example: mp3
fileSize:
type: number
description: File size in bytes
example: 1048576
mimeType:
type: string
description: MIME type
example: audio/mpeg
processedAt:
type: string
format: date-time
description: Processing timestamp
linkValidated:
type: boolean
description: For link submissions - validation status
example: true
additionalProperties: true
responses:
BadRequest:
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: error
message:
type: string
example: Invalid request parameters
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: error
message:
type: string
example: Unauthorized
NotFound:
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: error
message:
type: string
example: Resource not found
InternalServerError:
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: string
example: error
message:
type: string
example: Internal server error
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
JWT Authorization header using the Bearer scheme. Format: "Bearer
{token}"
````