Create a new asset

curl --request POST \
  --url https://api.royalti.io/asset \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Midnight City",
  "mainArtist": [
    "M83",
    "M47"
  ],
  "displayArtist": "M83",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "otherArtist": [
    "Featured Artist"
  ],
  "type": "Audio",
  "version": "Album Version",
  "isrc": "USRC17607839",
  "iswc": "T-123456789-0",
  "lyrics": "Waiting in a car...",
  "mainGenre": [
    "Electronic",
    "Synthpop"
  ],
  "subGenre": [
    "Synthwave"
  ],
  "contributors": {
    "producers": [
      "Producer Name"
    ],
    "mixers": [
      "Mixer Name"
    ],
    "songwriters": [
      "Songwriter Name"
    ]
  },
  "externalId": "EXT-12345",
  "extra": {
    "notes": "Recorded in Abbey Road Studios"
  },
  "metadata": {
    "releaseYear": 2011
  },
  "assetIDs": [
    "asset-1",
    "asset-2"
  ],
  "explicit": "clean",
  "label": "Royalti Records",
  "copyright": "© 2024 Royalti Records",
  "publisher": "Royalti Publishing",
  "copyrightOwner": "Royalti Music Group",
  "artists": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "primary"
    },
    "660e8400-e29b-41d4-a716-446655440001"
  ],
  "split": [
    {
      "user": "550e8400-e29b-41d4-a716-446655440002",
      "share": 60
    },
    {
      "user": "550e8400-e29b-41d4-a716-446655440003",
      "share": 40
    }
  ],
  "ddexMetadata": {
    "releaseType": "Single",
    "recordLabel": "Royalti Records"
  },
  "resourceReference": "SR123456789",
  "technicalResourceDetails": {
    "fileFormat": "WAV",
    "audioCodec": "PCM",
    "bitrate": 1411,
    "sampleRate": 44100,
    "duration": "PT3M45S"
  },
  "soundRecordingDetails": {
    "recordingDate": "2024-01-15",
    "recordingLocation": "Abbey Road Studios",
    "language": "en"
  },
  "musicalWorkReference": {
    "workId": "work-123",
    "iswc": "T-123456789-0"
  },
  "enableDDEX": false,
  "focusTrack": false,
  "danceStyle": [
    "Electronic Dance"
  ],
  "rhythmStyle": [
    "Upbeat"
  ],
  "instrumentation": [
    "Synthesizer",
    "Drums"
  ],
  "recordingLocation": "Abbey Road Studios",
  "recordingDate": "2024-01-15",
  "alternativeTitles": [
    "Alt Title 1",
    "Alt Title 2"
  ],
  "chartPositions": [
    {
      "chart": "Billboard Hot 100",
      "position": 10,
      "date": "2024-01-01"
    }
  ],
  "reviews": [
    {
      "reviewer": "Music Magazine",
      "rating": 4.5,
      "text": "Great track!"
    }
  ],
  "awards": [
    {
      "name": "Best Electronic Song",
      "year": 2024
    }
  ],
  "socialMediaHandles": {
    "twitter": "@artistname",
    "instagram": "@artistname"
  },
  "language": "en",
  "mood": [
    "Energetic",
    "Uplifting"
  ],
  "tempo": 128,
  "key": "C Major",
  "productionYear": 2024,
  "createdAt": "2026-01-15T02:52:25.458Z",
  "updatedAt": "2026-01-15T03:48:31.763Z",
  "Artists": [
    {
      "id": "e0dc6000-af34-4071-8a85-dcadace05c36",
      "artistName": "nedJamez",
      "type": "primary"
    }
  ],
  "Products": []
}
'

import requests

url = "https://api.royalti.io/asset"

payload = {
    "title": "Midnight City",
    "mainArtist": ["M83", "M47"],
    "displayArtist": "M83",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "otherArtist": ["Featured Artist"],
    "type": "Audio",
    "version": "Album Version",
    "isrc": "USRC17607839",
    "iswc": "T-123456789-0",
    "lyrics": "Waiting in a car...",
    "mainGenre": ["Electronic", "Synthpop"],
    "subGenre": ["Synthwave"],
    "contributors": {
        "producers": ["Producer Name"],
        "mixers": ["Mixer Name"],
        "songwriters": ["Songwriter Name"]
    },
    "externalId": "EXT-12345",
    "extra": { "notes": "Recorded in Abbey Road Studios" },
    "metadata": { "releaseYear": 2011 },
    "assetIDs": ["asset-1", "asset-2"],
    "explicit": "clean",
    "label": "Royalti Records",
    "copyright": "© 2024 Royalti Records",
    "publisher": "Royalti Publishing",
    "copyrightOwner": "Royalti Music Group",
    "artists": [
        {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "type": "primary"
        },
        "660e8400-e29b-41d4-a716-446655440001"
    ],
    "split": [
        {
            "user": "550e8400-e29b-41d4-a716-446655440002",
            "share": 60
        },
        {
            "user": "550e8400-e29b-41d4-a716-446655440003",
            "share": 40
        }
    ],
    "ddexMetadata": {
        "releaseType": "Single",
        "recordLabel": "Royalti Records"
    },
    "resourceReference": "SR123456789",
    "technicalResourceDetails": {
        "fileFormat": "WAV",
        "audioCodec": "PCM",
        "bitrate": 1411,
        "sampleRate": 44100,
        "duration": "PT3M45S"
    },
    "soundRecordingDetails": {
        "recordingDate": "2024-01-15",
        "recordingLocation": "Abbey Road Studios",
        "language": "en"
    },
    "musicalWorkReference": {
        "workId": "work-123",
        "iswc": "T-123456789-0"
    },
    "enableDDEX": False,
    "focusTrack": False,
    "danceStyle": ["Electronic Dance"],
    "rhythmStyle": ["Upbeat"],
    "instrumentation": ["Synthesizer", "Drums"],
    "recordingLocation": "Abbey Road Studios",
    "recordingDate": "2024-01-15",
    "alternativeTitles": ["Alt Title 1", "Alt Title 2"],
    "chartPositions": [
        {
            "chart": "Billboard Hot 100",
            "position": 10,
            "date": "2024-01-01"
        }
    ],
    "reviews": [
        {
            "reviewer": "Music Magazine",
            "rating": 4.5,
            "text": "Great track!"
        }
    ],
    "awards": [
        {
            "name": "Best Electronic Song",
            "year": 2024
        }
    ],
    "socialMediaHandles": {
        "twitter": "@artistname",
        "instagram": "@artistname"
    },
    "language": "en",
    "mood": ["Energetic", "Uplifting"],
    "tempo": 128,
    "key": "C Major",
    "productionYear": 2024,
    "createdAt": "2026-01-15T02:52:25.458Z",
    "updatedAt": "2026-01-15T03:48:31.763Z",
    "Artists": [
        {
            "id": "e0dc6000-af34-4071-8a85-dcadace05c36",
            "artistName": "nedJamez",
            "type": "primary"
        }
    ],
    "Products": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Midnight City',
    mainArtist: ['M83', 'M47'],
    displayArtist: 'M83',
    id: '550e8400-e29b-41d4-a716-446655440000',
    otherArtist: ['Featured Artist'],
    type: 'Audio',
    version: 'Album Version',
    isrc: 'USRC17607839',
    iswc: 'T-123456789-0',
    lyrics: 'Waiting in a car...',
    mainGenre: ['Electronic', 'Synthpop'],
    subGenre: ['Synthwave'],
    contributors: {
      producers: ['Producer Name'],
      mixers: ['Mixer Name'],
      songwriters: ['Songwriter Name']
    },
    externalId: 'EXT-12345',
    extra: {notes: 'Recorded in Abbey Road Studios'},
    metadata: {releaseYear: 2011},
    assetIDs: ['asset-1', 'asset-2'],
    explicit: 'clean',
    label: 'Royalti Records',
    copyright: '© 2024 Royalti Records',
    publisher: 'Royalti Publishing',
    copyrightOwner: 'Royalti Music Group',
    artists: [
      {id: '550e8400-e29b-41d4-a716-446655440000', type: 'primary'},
      '660e8400-e29b-41d4-a716-446655440001'
    ],
    split: [
      {user: '550e8400-e29b-41d4-a716-446655440002', share: 60},
      {user: '550e8400-e29b-41d4-a716-446655440003', share: 40}
    ],
    ddexMetadata: {releaseType: 'Single', recordLabel: 'Royalti Records'},
    resourceReference: 'SR123456789',
    technicalResourceDetails: {
      fileFormat: 'WAV',
      audioCodec: 'PCM',
      bitrate: 1411,
      sampleRate: 44100,
      duration: 'PT3M45S'
    },
    soundRecordingDetails: {
      recordingDate: '2024-01-15',
      recordingLocation: 'Abbey Road Studios',
      language: 'en'
    },
    musicalWorkReference: {workId: 'work-123', iswc: 'T-123456789-0'},
    enableDDEX: false,
    focusTrack: false,
    danceStyle: ['Electronic Dance'],
    rhythmStyle: ['Upbeat'],
    instrumentation: ['Synthesizer', 'Drums'],
    recordingLocation: 'Abbey Road Studios',
    recordingDate: '2024-01-15',
    alternativeTitles: ['Alt Title 1', 'Alt Title 2'],
    chartPositions: [{chart: 'Billboard Hot 100', position: 10, date: '2024-01-01'}],
    reviews: [{reviewer: 'Music Magazine', rating: 4.5, text: 'Great track!'}],
    awards: [{name: 'Best Electronic Song', year: 2024}],
    socialMediaHandles: {twitter: '@artistname', instagram: '@artistname'},
    language: 'en',
    mood: ['Energetic', 'Uplifting'],
    tempo: 128,
    key: 'C Major',
    productionYear: 2024,
    createdAt: '2026-01-15T02:52:25.458Z',
    updatedAt: '2026-01-15T03:48:31.763Z',
    Artists: [
      {
        id: 'e0dc6000-af34-4071-8a85-dcadace05c36',
        artistName: 'nedJamez',
        type: 'primary'
      }
    ],
    Products: []
  })
};

fetch('https://api.royalti.io/asset', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.royalti.io/asset",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Midnight City',
    'mainArtist' => [
        'M83',
        'M47'
    ],
    'displayArtist' => 'M83',
    'id' => '550e8400-e29b-41d4-a716-446655440000',
    'otherArtist' => [
        'Featured Artist'
    ],
    'type' => 'Audio',
    'version' => 'Album Version',
    'isrc' => 'USRC17607839',
    'iswc' => 'T-123456789-0',
    'lyrics' => 'Waiting in a car...',
    'mainGenre' => [
        'Electronic',
        'Synthpop'
    ],
    'subGenre' => [
        'Synthwave'
    ],
    'contributors' => [
        'producers' => [
                'Producer Name'
        ],
        'mixers' => [
                'Mixer Name'
        ],
        'songwriters' => [
                'Songwriter Name'
        ]
    ],
    'externalId' => 'EXT-12345',
    'extra' => [
        'notes' => 'Recorded in Abbey Road Studios'
    ],
    'metadata' => [
        'releaseYear' => 2011
    ],
    'assetIDs' => [
        'asset-1',
        'asset-2'
    ],
    'explicit' => 'clean',
    'label' => 'Royalti Records',
    'copyright' => '© 2024 Royalti Records',
    'publisher' => 'Royalti Publishing',
    'copyrightOwner' => 'Royalti Music Group',
    'artists' => [
        [
                'id' => '550e8400-e29b-41d4-a716-446655440000',
                'type' => 'primary'
        ],
        '660e8400-e29b-41d4-a716-446655440001'
    ],
    'split' => [
        [
                'user' => '550e8400-e29b-41d4-a716-446655440002',
                'share' => 60
        ],
        [
                'user' => '550e8400-e29b-41d4-a716-446655440003',
                'share' => 40
        ]
    ],
    'ddexMetadata' => [
        'releaseType' => 'Single',
        'recordLabel' => 'Royalti Records'
    ],
    'resourceReference' => 'SR123456789',
    'technicalResourceDetails' => [
        'fileFormat' => 'WAV',
        'audioCodec' => 'PCM',
        'bitrate' => 1411,
        'sampleRate' => 44100,
        'duration' => 'PT3M45S'
    ],
    'soundRecordingDetails' => [
        'recordingDate' => '2024-01-15',
        'recordingLocation' => 'Abbey Road Studios',
        'language' => 'en'
    ],
    'musicalWorkReference' => [
        'workId' => 'work-123',
        'iswc' => 'T-123456789-0'
    ],
    'enableDDEX' => false,
    'focusTrack' => false,
    'danceStyle' => [
        'Electronic Dance'
    ],
    'rhythmStyle' => [
        'Upbeat'
    ],
    'instrumentation' => [
        'Synthesizer',
        'Drums'
    ],
    'recordingLocation' => 'Abbey Road Studios',
    'recordingDate' => '2024-01-15',
    'alternativeTitles' => [
        'Alt Title 1',
        'Alt Title 2'
    ],
    'chartPositions' => [
        [
                'chart' => 'Billboard Hot 100',
                'position' => 10,
                'date' => '2024-01-01'
        ]
    ],
    'reviews' => [
        [
                'reviewer' => 'Music Magazine',
                'rating' => 4.5,
                'text' => 'Great track!'
        ]
    ],
    'awards' => [
        [
                'name' => 'Best Electronic Song',
                'year' => 2024
        ]
    ],
    'socialMediaHandles' => [
        'twitter' => '@artistname',
        'instagram' => '@artistname'
    ],
    'language' => 'en',
    'mood' => [
        'Energetic',
        'Uplifting'
    ],
    'tempo' => 128,
    'key' => 'C Major',
    'productionYear' => 2024,
    'createdAt' => '2026-01-15T02:52:25.458Z',
    'updatedAt' => '2026-01-15T03:48:31.763Z',
    'Artists' => [
        [
                'id' => 'e0dc6000-af34-4071-8a85-dcadace05c36',
                'artistName' => 'nedJamez',
                'type' => 'primary'
        ]
    ],
    'Products' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.royalti.io/asset"

	payload := strings.NewReader("{\n  \"title\": \"Midnight City\",\n  \"mainArtist\": [\n    \"M83\",\n    \"M47\"\n  ],\n  \"displayArtist\": \"M83\",\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"otherArtist\": [\n    \"Featured Artist\"\n  ],\n  \"type\": \"Audio\",\n  \"version\": \"Album Version\",\n  \"isrc\": \"USRC17607839\",\n  \"iswc\": \"T-123456789-0\",\n  \"lyrics\": \"Waiting in a car...\",\n  \"mainGenre\": [\n    \"Electronic\",\n    \"Synthpop\"\n  ],\n  \"subGenre\": [\n    \"Synthwave\"\n  ],\n  \"contributors\": {\n    \"producers\": [\n      \"Producer Name\"\n    ],\n    \"mixers\": [\n      \"Mixer Name\"\n    ],\n    \"songwriters\": [\n      \"Songwriter Name\"\n    ]\n  },\n  \"externalId\": \"EXT-12345\",\n  \"extra\": {\n    \"notes\": \"Recorded in Abbey Road Studios\"\n  },\n  \"metadata\": {\n    \"releaseYear\": 2011\n  },\n  \"assetIDs\": [\n    \"asset-1\",\n    \"asset-2\"\n  ],\n  \"explicit\": \"clean\",\n  \"label\": \"Royalti Records\",\n  \"copyright\": \"© 2024 Royalti Records\",\n  \"publisher\": \"Royalti Publishing\",\n  \"copyrightOwner\": \"Royalti Music Group\",\n  \"artists\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"type\": \"primary\"\n    },\n    \"660e8400-e29b-41d4-a716-446655440001\"\n  ],\n  \"split\": [\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440002\",\n      \"share\": 60\n    },\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440003\",\n      \"share\": 40\n    }\n  ],\n  \"ddexMetadata\": {\n    \"releaseType\": \"Single\",\n    \"recordLabel\": \"Royalti Records\"\n  },\n  \"resourceReference\": \"SR123456789\",\n  \"technicalResourceDetails\": {\n    \"fileFormat\": \"WAV\",\n    \"audioCodec\": \"PCM\",\n    \"bitrate\": 1411,\n    \"sampleRate\": 44100,\n    \"duration\": \"PT3M45S\"\n  },\n  \"soundRecordingDetails\": {\n    \"recordingDate\": \"2024-01-15\",\n    \"recordingLocation\": \"Abbey Road Studios\",\n    \"language\": \"en\"\n  },\n  \"musicalWorkReference\": {\n    \"workId\": \"work-123\",\n    \"iswc\": \"T-123456789-0\"\n  },\n  \"enableDDEX\": false,\n  \"focusTrack\": false,\n  \"danceStyle\": [\n    \"Electronic Dance\"\n  ],\n  \"rhythmStyle\": [\n    \"Upbeat\"\n  ],\n  \"instrumentation\": [\n    \"Synthesizer\",\n    \"Drums\"\n  ],\n  \"recordingLocation\": \"Abbey Road Studios\",\n  \"recordingDate\": \"2024-01-15\",\n  \"alternativeTitles\": [\n    \"Alt Title 1\",\n    \"Alt Title 2\"\n  ],\n  \"chartPositions\": [\n    {\n      \"chart\": \"Billboard Hot 100\",\n      \"position\": 10,\n      \"date\": \"2024-01-01\"\n    }\n  ],\n  \"reviews\": [\n    {\n      \"reviewer\": \"Music Magazine\",\n      \"rating\": 4.5,\n      \"text\": \"Great track!\"\n    }\n  ],\n  \"awards\": [\n    {\n      \"name\": \"Best Electronic Song\",\n      \"year\": 2024\n    }\n  ],\n  \"socialMediaHandles\": {\n    \"twitter\": \"@artistname\",\n    \"instagram\": \"@artistname\"\n  },\n  \"language\": \"en\",\n  \"mood\": [\n    \"Energetic\",\n    \"Uplifting\"\n  ],\n  \"tempo\": 128,\n  \"key\": \"C Major\",\n  \"productionYear\": 2024,\n  \"createdAt\": \"2026-01-15T02:52:25.458Z\",\n  \"updatedAt\": \"2026-01-15T03:48:31.763Z\",\n  \"Artists\": [\n    {\n      \"id\": \"e0dc6000-af34-4071-8a85-dcadace05c36\",\n      \"artistName\": \"nedJamez\",\n      \"type\": \"primary\"\n    }\n  ],\n  \"Products\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.royalti.io/asset")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Midnight City\",\n  \"mainArtist\": [\n    \"M83\",\n    \"M47\"\n  ],\n  \"displayArtist\": \"M83\",\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"otherArtist\": [\n    \"Featured Artist\"\n  ],\n  \"type\": \"Audio\",\n  \"version\": \"Album Version\",\n  \"isrc\": \"USRC17607839\",\n  \"iswc\": \"T-123456789-0\",\n  \"lyrics\": \"Waiting in a car...\",\n  \"mainGenre\": [\n    \"Electronic\",\n    \"Synthpop\"\n  ],\n  \"subGenre\": [\n    \"Synthwave\"\n  ],\n  \"contributors\": {\n    \"producers\": [\n      \"Producer Name\"\n    ],\n    \"mixers\": [\n      \"Mixer Name\"\n    ],\n    \"songwriters\": [\n      \"Songwriter Name\"\n    ]\n  },\n  \"externalId\": \"EXT-12345\",\n  \"extra\": {\n    \"notes\": \"Recorded in Abbey Road Studios\"\n  },\n  \"metadata\": {\n    \"releaseYear\": 2011\n  },\n  \"assetIDs\": [\n    \"asset-1\",\n    \"asset-2\"\n  ],\n  \"explicit\": \"clean\",\n  \"label\": \"Royalti Records\",\n  \"copyright\": \"© 2024 Royalti Records\",\n  \"publisher\": \"Royalti Publishing\",\n  \"copyrightOwner\": \"Royalti Music Group\",\n  \"artists\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"type\": \"primary\"\n    },\n    \"660e8400-e29b-41d4-a716-446655440001\"\n  ],\n  \"split\": [\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440002\",\n      \"share\": 60\n    },\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440003\",\n      \"share\": 40\n    }\n  ],\n  \"ddexMetadata\": {\n    \"releaseType\": \"Single\",\n    \"recordLabel\": \"Royalti Records\"\n  },\n  \"resourceReference\": \"SR123456789\",\n  \"technicalResourceDetails\": {\n    \"fileFormat\": \"WAV\",\n    \"audioCodec\": \"PCM\",\n    \"bitrate\": 1411,\n    \"sampleRate\": 44100,\n    \"duration\": \"PT3M45S\"\n  },\n  \"soundRecordingDetails\": {\n    \"recordingDate\": \"2024-01-15\",\n    \"recordingLocation\": \"Abbey Road Studios\",\n    \"language\": \"en\"\n  },\n  \"musicalWorkReference\": {\n    \"workId\": \"work-123\",\n    \"iswc\": \"T-123456789-0\"\n  },\n  \"enableDDEX\": false,\n  \"focusTrack\": false,\n  \"danceStyle\": [\n    \"Electronic Dance\"\n  ],\n  \"rhythmStyle\": [\n    \"Upbeat\"\n  ],\n  \"instrumentation\": [\n    \"Synthesizer\",\n    \"Drums\"\n  ],\n  \"recordingLocation\": \"Abbey Road Studios\",\n  \"recordingDate\": \"2024-01-15\",\n  \"alternativeTitles\": [\n    \"Alt Title 1\",\n    \"Alt Title 2\"\n  ],\n  \"chartPositions\": [\n    {\n      \"chart\": \"Billboard Hot 100\",\n      \"position\": 10,\n      \"date\": \"2024-01-01\"\n    }\n  ],\n  \"reviews\": [\n    {\n      \"reviewer\": \"Music Magazine\",\n      \"rating\": 4.5,\n      \"text\": \"Great track!\"\n    }\n  ],\n  \"awards\": [\n    {\n      \"name\": \"Best Electronic Song\",\n      \"year\": 2024\n    }\n  ],\n  \"socialMediaHandles\": {\n    \"twitter\": \"@artistname\",\n    \"instagram\": \"@artistname\"\n  },\n  \"language\": \"en\",\n  \"mood\": [\n    \"Energetic\",\n    \"Uplifting\"\n  ],\n  \"tempo\": 128,\n  \"key\": \"C Major\",\n  \"productionYear\": 2024,\n  \"createdAt\": \"2026-01-15T02:52:25.458Z\",\n  \"updatedAt\": \"2026-01-15T03:48:31.763Z\",\n  \"Artists\": [\n    {\n      \"id\": \"e0dc6000-af34-4071-8a85-dcadace05c36\",\n      \"artistName\": \"nedJamez\",\n      \"type\": \"primary\"\n    }\n  ],\n  \"Products\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.royalti.io/asset")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Midnight City\",\n  \"mainArtist\": [\n    \"M83\",\n    \"M47\"\n  ],\n  \"displayArtist\": \"M83\",\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"otherArtist\": [\n    \"Featured Artist\"\n  ],\n  \"type\": \"Audio\",\n  \"version\": \"Album Version\",\n  \"isrc\": \"USRC17607839\",\n  \"iswc\": \"T-123456789-0\",\n  \"lyrics\": \"Waiting in a car...\",\n  \"mainGenre\": [\n    \"Electronic\",\n    \"Synthpop\"\n  ],\n  \"subGenre\": [\n    \"Synthwave\"\n  ],\n  \"contributors\": {\n    \"producers\": [\n      \"Producer Name\"\n    ],\n    \"mixers\": [\n      \"Mixer Name\"\n    ],\n    \"songwriters\": [\n      \"Songwriter Name\"\n    ]\n  },\n  \"externalId\": \"EXT-12345\",\n  \"extra\": {\n    \"notes\": \"Recorded in Abbey Road Studios\"\n  },\n  \"metadata\": {\n    \"releaseYear\": 2011\n  },\n  \"assetIDs\": [\n    \"asset-1\",\n    \"asset-2\"\n  ],\n  \"explicit\": \"clean\",\n  \"label\": \"Royalti Records\",\n  \"copyright\": \"© 2024 Royalti Records\",\n  \"publisher\": \"Royalti Publishing\",\n  \"copyrightOwner\": \"Royalti Music Group\",\n  \"artists\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"type\": \"primary\"\n    },\n    \"660e8400-e29b-41d4-a716-446655440001\"\n  ],\n  \"split\": [\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440002\",\n      \"share\": 60\n    },\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440003\",\n      \"share\": 40\n    }\n  ],\n  \"ddexMetadata\": {\n    \"releaseType\": \"Single\",\n    \"recordLabel\": \"Royalti Records\"\n  },\n  \"resourceReference\": \"SR123456789\",\n  \"technicalResourceDetails\": {\n    \"fileFormat\": \"WAV\",\n    \"audioCodec\": \"PCM\",\n    \"bitrate\": 1411,\n    \"sampleRate\": 44100,\n    \"duration\": \"PT3M45S\"\n  },\n  \"soundRecordingDetails\": {\n    \"recordingDate\": \"2024-01-15\",\n    \"recordingLocation\": \"Abbey Road Studios\",\n    \"language\": \"en\"\n  },\n  \"musicalWorkReference\": {\n    \"workId\": \"work-123\",\n    \"iswc\": \"T-123456789-0\"\n  },\n  \"enableDDEX\": false,\n  \"focusTrack\": false,\n  \"danceStyle\": [\n    \"Electronic Dance\"\n  ],\n  \"rhythmStyle\": [\n    \"Upbeat\"\n  ],\n  \"instrumentation\": [\n    \"Synthesizer\",\n    \"Drums\"\n  ],\n  \"recordingLocation\": \"Abbey Road Studios\",\n  \"recordingDate\": \"2024-01-15\",\n  \"alternativeTitles\": [\n    \"Alt Title 1\",\n    \"Alt Title 2\"\n  ],\n  \"chartPositions\": [\n    {\n      \"chart\": \"Billboard Hot 100\",\n      \"position\": 10,\n      \"date\": \"2024-01-01\"\n    }\n  ],\n  \"reviews\": [\n    {\n      \"reviewer\": \"Music Magazine\",\n      \"rating\": 4.5,\n      \"text\": \"Great track!\"\n    }\n  ],\n  \"awards\": [\n    {\n      \"name\": \"Best Electronic Song\",\n      \"year\": 2024\n    }\n  ],\n  \"socialMediaHandles\": {\n    \"twitter\": \"@artistname\",\n    \"instagram\": \"@artistname\"\n  },\n  \"language\": \"en\",\n  \"mood\": [\n    \"Energetic\",\n    \"Uplifting\"\n  ],\n  \"tempo\": 128,\n  \"key\": \"C Major\",\n  \"productionYear\": 2024,\n  \"createdAt\": \"2026-01-15T02:52:25.458Z\",\n  \"updatedAt\": \"2026-01-15T03:48:31.763Z\",\n  \"Artists\": [\n    {\n      \"id\": \"e0dc6000-af34-4071-8a85-dcadace05c36\",\n      \"artistName\": \"nedJamez\",\n      \"type\": \"primary\"\n    }\n  ],\n  \"Products\": []\n}"

response = http.request(request)
puts response.read_body

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Example Song",
  "type": "Audio",
  "ddexMetadata": null,
  "focusTrack": false,
  "media": [],
  "explicit": null,
  "mainArtist": [
    "M83",
    "M47"
  ],
  "displayArtist": "M83",
  "version": "Album Version",
  "mainGenre": [
    "Electronic",
    "Mental"
  ],
  "subGenre": [
    "Synthwave"
  ],
  "contributors": {
    "producers": [
      "Producer Name"
    ],
    "mixers": [
      "Mixer Name"
    ]
  },
  "iswc": "T-123456789-0",
  "externalId": "EXT-12345",
  "isrc": "USRC17607839",
  "updatedAt": "2025-08-21T11:42:29.827Z",
  "createdAt": "2025-08-21T11:42:29.827Z",
  "assetIDs": null,
  "otherArtist": null,
  "lyrics": null,
  "extra": null,
  "danceStyle": null,
  "rhythmStyle": null,
  "instrumentation": null,
  "recordingLocation": null,
  "recordingDate": null,
  "alternativeTitles": null,
  "chartPositions": null,
  "reviews": null,
  "awards": null,
  "socialMediaHandles": null,
  "language": null,
  "mood": null,
  "tempo": null,
  "key": null,
  "copyrightOwner": null,
  "productionYear": null,
  "metadata": null
}

{
  "status": "error",
  "message": "Invalid request parameters"
}

{
  "status": "error",
  "message": "Unauthorized"
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

POST

asset

Create a new asset

curl --request POST \
  --url https://api.royalti.io/asset \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Midnight City",
  "mainArtist": [
    "M83",
    "M47"
  ],
  "displayArtist": "M83",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "otherArtist": [
    "Featured Artist"
  ],
  "type": "Audio",
  "version": "Album Version",
  "isrc": "USRC17607839",
  "iswc": "T-123456789-0",
  "lyrics": "Waiting in a car...",
  "mainGenre": [
    "Electronic",
    "Synthpop"
  ],
  "subGenre": [
    "Synthwave"
  ],
  "contributors": {
    "producers": [
      "Producer Name"
    ],
    "mixers": [
      "Mixer Name"
    ],
    "songwriters": [
      "Songwriter Name"
    ]
  },
  "externalId": "EXT-12345",
  "extra": {
    "notes": "Recorded in Abbey Road Studios"
  },
  "metadata": {
    "releaseYear": 2011
  },
  "assetIDs": [
    "asset-1",
    "asset-2"
  ],
  "explicit": "clean",
  "label": "Royalti Records",
  "copyright": "© 2024 Royalti Records",
  "publisher": "Royalti Publishing",
  "copyrightOwner": "Royalti Music Group",
  "artists": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "primary"
    },
    "660e8400-e29b-41d4-a716-446655440001"
  ],
  "split": [
    {
      "user": "550e8400-e29b-41d4-a716-446655440002",
      "share": 60
    },
    {
      "user": "550e8400-e29b-41d4-a716-446655440003",
      "share": 40
    }
  ],
  "ddexMetadata": {
    "releaseType": "Single",
    "recordLabel": "Royalti Records"
  },
  "resourceReference": "SR123456789",
  "technicalResourceDetails": {
    "fileFormat": "WAV",
    "audioCodec": "PCM",
    "bitrate": 1411,
    "sampleRate": 44100,
    "duration": "PT3M45S"
  },
  "soundRecordingDetails": {
    "recordingDate": "2024-01-15",
    "recordingLocation": "Abbey Road Studios",
    "language": "en"
  },
  "musicalWorkReference": {
    "workId": "work-123",
    "iswc": "T-123456789-0"
  },
  "enableDDEX": false,
  "focusTrack": false,
  "danceStyle": [
    "Electronic Dance"
  ],
  "rhythmStyle": [
    "Upbeat"
  ],
  "instrumentation": [
    "Synthesizer",
    "Drums"
  ],
  "recordingLocation": "Abbey Road Studios",
  "recordingDate": "2024-01-15",
  "alternativeTitles": [
    "Alt Title 1",
    "Alt Title 2"
  ],
  "chartPositions": [
    {
      "chart": "Billboard Hot 100",
      "position": 10,
      "date": "2024-01-01"
    }
  ],
  "reviews": [
    {
      "reviewer": "Music Magazine",
      "rating": 4.5,
      "text": "Great track!"
    }
  ],
  "awards": [
    {
      "name": "Best Electronic Song",
      "year": 2024
    }
  ],
  "socialMediaHandles": {
    "twitter": "@artistname",
    "instagram": "@artistname"
  },
  "language": "en",
  "mood": [
    "Energetic",
    "Uplifting"
  ],
  "tempo": 128,
  "key": "C Major",
  "productionYear": 2024,
  "createdAt": "2026-01-15T02:52:25.458Z",
  "updatedAt": "2026-01-15T03:48:31.763Z",
  "Artists": [
    {
      "id": "e0dc6000-af34-4071-8a85-dcadace05c36",
      "artistName": "nedJamez",
      "type": "primary"
    }
  ],
  "Products": []
}
'

import requests

url = "https://api.royalti.io/asset"

payload = {
    "title": "Midnight City",
    "mainArtist": ["M83", "M47"],
    "displayArtist": "M83",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "otherArtist": ["Featured Artist"],
    "type": "Audio",
    "version": "Album Version",
    "isrc": "USRC17607839",
    "iswc": "T-123456789-0",
    "lyrics": "Waiting in a car...",
    "mainGenre": ["Electronic", "Synthpop"],
    "subGenre": ["Synthwave"],
    "contributors": {
        "producers": ["Producer Name"],
        "mixers": ["Mixer Name"],
        "songwriters": ["Songwriter Name"]
    },
    "externalId": "EXT-12345",
    "extra": { "notes": "Recorded in Abbey Road Studios" },
    "metadata": { "releaseYear": 2011 },
    "assetIDs": ["asset-1", "asset-2"],
    "explicit": "clean",
    "label": "Royalti Records",
    "copyright": "© 2024 Royalti Records",
    "publisher": "Royalti Publishing",
    "copyrightOwner": "Royalti Music Group",
    "artists": [
        {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "type": "primary"
        },
        "660e8400-e29b-41d4-a716-446655440001"
    ],
    "split": [
        {
            "user": "550e8400-e29b-41d4-a716-446655440002",
            "share": 60
        },
        {
            "user": "550e8400-e29b-41d4-a716-446655440003",
            "share": 40
        }
    ],
    "ddexMetadata": {
        "releaseType": "Single",
        "recordLabel": "Royalti Records"
    },
    "resourceReference": "SR123456789",
    "technicalResourceDetails": {
        "fileFormat": "WAV",
        "audioCodec": "PCM",
        "bitrate": 1411,
        "sampleRate": 44100,
        "duration": "PT3M45S"
    },
    "soundRecordingDetails": {
        "recordingDate": "2024-01-15",
        "recordingLocation": "Abbey Road Studios",
        "language": "en"
    },
    "musicalWorkReference": {
        "workId": "work-123",
        "iswc": "T-123456789-0"
    },
    "enableDDEX": False,
    "focusTrack": False,
    "danceStyle": ["Electronic Dance"],
    "rhythmStyle": ["Upbeat"],
    "instrumentation": ["Synthesizer", "Drums"],
    "recordingLocation": "Abbey Road Studios",
    "recordingDate": "2024-01-15",
    "alternativeTitles": ["Alt Title 1", "Alt Title 2"],
    "chartPositions": [
        {
            "chart": "Billboard Hot 100",
            "position": 10,
            "date": "2024-01-01"
        }
    ],
    "reviews": [
        {
            "reviewer": "Music Magazine",
            "rating": 4.5,
            "text": "Great track!"
        }
    ],
    "awards": [
        {
            "name": "Best Electronic Song",
            "year": 2024
        }
    ],
    "socialMediaHandles": {
        "twitter": "@artistname",
        "instagram": "@artistname"
    },
    "language": "en",
    "mood": ["Energetic", "Uplifting"],
    "tempo": 128,
    "key": "C Major",
    "productionYear": 2024,
    "createdAt": "2026-01-15T02:52:25.458Z",
    "updatedAt": "2026-01-15T03:48:31.763Z",
    "Artists": [
        {
            "id": "e0dc6000-af34-4071-8a85-dcadace05c36",
            "artistName": "nedJamez",
            "type": "primary"
        }
    ],
    "Products": []
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Midnight City',
    mainArtist: ['M83', 'M47'],
    displayArtist: 'M83',
    id: '550e8400-e29b-41d4-a716-446655440000',
    otherArtist: ['Featured Artist'],
    type: 'Audio',
    version: 'Album Version',
    isrc: 'USRC17607839',
    iswc: 'T-123456789-0',
    lyrics: 'Waiting in a car...',
    mainGenre: ['Electronic', 'Synthpop'],
    subGenre: ['Synthwave'],
    contributors: {
      producers: ['Producer Name'],
      mixers: ['Mixer Name'],
      songwriters: ['Songwriter Name']
    },
    externalId: 'EXT-12345',
    extra: {notes: 'Recorded in Abbey Road Studios'},
    metadata: {releaseYear: 2011},
    assetIDs: ['asset-1', 'asset-2'],
    explicit: 'clean',
    label: 'Royalti Records',
    copyright: '© 2024 Royalti Records',
    publisher: 'Royalti Publishing',
    copyrightOwner: 'Royalti Music Group',
    artists: [
      {id: '550e8400-e29b-41d4-a716-446655440000', type: 'primary'},
      '660e8400-e29b-41d4-a716-446655440001'
    ],
    split: [
      {user: '550e8400-e29b-41d4-a716-446655440002', share: 60},
      {user: '550e8400-e29b-41d4-a716-446655440003', share: 40}
    ],
    ddexMetadata: {releaseType: 'Single', recordLabel: 'Royalti Records'},
    resourceReference: 'SR123456789',
    technicalResourceDetails: {
      fileFormat: 'WAV',
      audioCodec: 'PCM',
      bitrate: 1411,
      sampleRate: 44100,
      duration: 'PT3M45S'
    },
    soundRecordingDetails: {
      recordingDate: '2024-01-15',
      recordingLocation: 'Abbey Road Studios',
      language: 'en'
    },
    musicalWorkReference: {workId: 'work-123', iswc: 'T-123456789-0'},
    enableDDEX: false,
    focusTrack: false,
    danceStyle: ['Electronic Dance'],
    rhythmStyle: ['Upbeat'],
    instrumentation: ['Synthesizer', 'Drums'],
    recordingLocation: 'Abbey Road Studios',
    recordingDate: '2024-01-15',
    alternativeTitles: ['Alt Title 1', 'Alt Title 2'],
    chartPositions: [{chart: 'Billboard Hot 100', position: 10, date: '2024-01-01'}],
    reviews: [{reviewer: 'Music Magazine', rating: 4.5, text: 'Great track!'}],
    awards: [{name: 'Best Electronic Song', year: 2024}],
    socialMediaHandles: {twitter: '@artistname', instagram: '@artistname'},
    language: 'en',
    mood: ['Energetic', 'Uplifting'],
    tempo: 128,
    key: 'C Major',
    productionYear: 2024,
    createdAt: '2026-01-15T02:52:25.458Z',
    updatedAt: '2026-01-15T03:48:31.763Z',
    Artists: [
      {
        id: 'e0dc6000-af34-4071-8a85-dcadace05c36',
        artistName: 'nedJamez',
        type: 'primary'
      }
    ],
    Products: []
  })
};

fetch('https://api.royalti.io/asset', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.royalti.io/asset",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Midnight City',
    'mainArtist' => [
        'M83',
        'M47'
    ],
    'displayArtist' => 'M83',
    'id' => '550e8400-e29b-41d4-a716-446655440000',
    'otherArtist' => [
        'Featured Artist'
    ],
    'type' => 'Audio',
    'version' => 'Album Version',
    'isrc' => 'USRC17607839',
    'iswc' => 'T-123456789-0',
    'lyrics' => 'Waiting in a car...',
    'mainGenre' => [
        'Electronic',
        'Synthpop'
    ],
    'subGenre' => [
        'Synthwave'
    ],
    'contributors' => [
        'producers' => [
                'Producer Name'
        ],
        'mixers' => [
                'Mixer Name'
        ],
        'songwriters' => [
                'Songwriter Name'
        ]
    ],
    'externalId' => 'EXT-12345',
    'extra' => [
        'notes' => 'Recorded in Abbey Road Studios'
    ],
    'metadata' => [
        'releaseYear' => 2011
    ],
    'assetIDs' => [
        'asset-1',
        'asset-2'
    ],
    'explicit' => 'clean',
    'label' => 'Royalti Records',
    'copyright' => '© 2024 Royalti Records',
    'publisher' => 'Royalti Publishing',
    'copyrightOwner' => 'Royalti Music Group',
    'artists' => [
        [
                'id' => '550e8400-e29b-41d4-a716-446655440000',
                'type' => 'primary'
        ],
        '660e8400-e29b-41d4-a716-446655440001'
    ],
    'split' => [
        [
                'user' => '550e8400-e29b-41d4-a716-446655440002',
                'share' => 60
        ],
        [
                'user' => '550e8400-e29b-41d4-a716-446655440003',
                'share' => 40
        ]
    ],
    'ddexMetadata' => [
        'releaseType' => 'Single',
        'recordLabel' => 'Royalti Records'
    ],
    'resourceReference' => 'SR123456789',
    'technicalResourceDetails' => [
        'fileFormat' => 'WAV',
        'audioCodec' => 'PCM',
        'bitrate' => 1411,
        'sampleRate' => 44100,
        'duration' => 'PT3M45S'
    ],
    'soundRecordingDetails' => [
        'recordingDate' => '2024-01-15',
        'recordingLocation' => 'Abbey Road Studios',
        'language' => 'en'
    ],
    'musicalWorkReference' => [
        'workId' => 'work-123',
        'iswc' => 'T-123456789-0'
    ],
    'enableDDEX' => false,
    'focusTrack' => false,
    'danceStyle' => [
        'Electronic Dance'
    ],
    'rhythmStyle' => [
        'Upbeat'
    ],
    'instrumentation' => [
        'Synthesizer',
        'Drums'
    ],
    'recordingLocation' => 'Abbey Road Studios',
    'recordingDate' => '2024-01-15',
    'alternativeTitles' => [
        'Alt Title 1',
        'Alt Title 2'
    ],
    'chartPositions' => [
        [
                'chart' => 'Billboard Hot 100',
                'position' => 10,
                'date' => '2024-01-01'
        ]
    ],
    'reviews' => [
        [
                'reviewer' => 'Music Magazine',
                'rating' => 4.5,
                'text' => 'Great track!'
        ]
    ],
    'awards' => [
        [
                'name' => 'Best Electronic Song',
                'year' => 2024
        ]
    ],
    'socialMediaHandles' => [
        'twitter' => '@artistname',
        'instagram' => '@artistname'
    ],
    'language' => 'en',
    'mood' => [
        'Energetic',
        'Uplifting'
    ],
    'tempo' => 128,
    'key' => 'C Major',
    'productionYear' => 2024,
    'createdAt' => '2026-01-15T02:52:25.458Z',
    'updatedAt' => '2026-01-15T03:48:31.763Z',
    'Artists' => [
        [
                'id' => 'e0dc6000-af34-4071-8a85-dcadace05c36',
                'artistName' => 'nedJamez',
                'type' => 'primary'
        ]
    ],
    'Products' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.royalti.io/asset"

	payload := strings.NewReader("{\n  \"title\": \"Midnight City\",\n  \"mainArtist\": [\n    \"M83\",\n    \"M47\"\n  ],\n  \"displayArtist\": \"M83\",\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"otherArtist\": [\n    \"Featured Artist\"\n  ],\n  \"type\": \"Audio\",\n  \"version\": \"Album Version\",\n  \"isrc\": \"USRC17607839\",\n  \"iswc\": \"T-123456789-0\",\n  \"lyrics\": \"Waiting in a car...\",\n  \"mainGenre\": [\n    \"Electronic\",\n    \"Synthpop\"\n  ],\n  \"subGenre\": [\n    \"Synthwave\"\n  ],\n  \"contributors\": {\n    \"producers\": [\n      \"Producer Name\"\n    ],\n    \"mixers\": [\n      \"Mixer Name\"\n    ],\n    \"songwriters\": [\n      \"Songwriter Name\"\n    ]\n  },\n  \"externalId\": \"EXT-12345\",\n  \"extra\": {\n    \"notes\": \"Recorded in Abbey Road Studios\"\n  },\n  \"metadata\": {\n    \"releaseYear\": 2011\n  },\n  \"assetIDs\": [\n    \"asset-1\",\n    \"asset-2\"\n  ],\n  \"explicit\": \"clean\",\n  \"label\": \"Royalti Records\",\n  \"copyright\": \"© 2024 Royalti Records\",\n  \"publisher\": \"Royalti Publishing\",\n  \"copyrightOwner\": \"Royalti Music Group\",\n  \"artists\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"type\": \"primary\"\n    },\n    \"660e8400-e29b-41d4-a716-446655440001\"\n  ],\n  \"split\": [\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440002\",\n      \"share\": 60\n    },\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440003\",\n      \"share\": 40\n    }\n  ],\n  \"ddexMetadata\": {\n    \"releaseType\": \"Single\",\n    \"recordLabel\": \"Royalti Records\"\n  },\n  \"resourceReference\": \"SR123456789\",\n  \"technicalResourceDetails\": {\n    \"fileFormat\": \"WAV\",\n    \"audioCodec\": \"PCM\",\n    \"bitrate\": 1411,\n    \"sampleRate\": 44100,\n    \"duration\": \"PT3M45S\"\n  },\n  \"soundRecordingDetails\": {\n    \"recordingDate\": \"2024-01-15\",\n    \"recordingLocation\": \"Abbey Road Studios\",\n    \"language\": \"en\"\n  },\n  \"musicalWorkReference\": {\n    \"workId\": \"work-123\",\n    \"iswc\": \"T-123456789-0\"\n  },\n  \"enableDDEX\": false,\n  \"focusTrack\": false,\n  \"danceStyle\": [\n    \"Electronic Dance\"\n  ],\n  \"rhythmStyle\": [\n    \"Upbeat\"\n  ],\n  \"instrumentation\": [\n    \"Synthesizer\",\n    \"Drums\"\n  ],\n  \"recordingLocation\": \"Abbey Road Studios\",\n  \"recordingDate\": \"2024-01-15\",\n  \"alternativeTitles\": [\n    \"Alt Title 1\",\n    \"Alt Title 2\"\n  ],\n  \"chartPositions\": [\n    {\n      \"chart\": \"Billboard Hot 100\",\n      \"position\": 10,\n      \"date\": \"2024-01-01\"\n    }\n  ],\n  \"reviews\": [\n    {\n      \"reviewer\": \"Music Magazine\",\n      \"rating\": 4.5,\n      \"text\": \"Great track!\"\n    }\n  ],\n  \"awards\": [\n    {\n      \"name\": \"Best Electronic Song\",\n      \"year\": 2024\n    }\n  ],\n  \"socialMediaHandles\": {\n    \"twitter\": \"@artistname\",\n    \"instagram\": \"@artistname\"\n  },\n  \"language\": \"en\",\n  \"mood\": [\n    \"Energetic\",\n    \"Uplifting\"\n  ],\n  \"tempo\": 128,\n  \"key\": \"C Major\",\n  \"productionYear\": 2024,\n  \"createdAt\": \"2026-01-15T02:52:25.458Z\",\n  \"updatedAt\": \"2026-01-15T03:48:31.763Z\",\n  \"Artists\": [\n    {\n      \"id\": \"e0dc6000-af34-4071-8a85-dcadace05c36\",\n      \"artistName\": \"nedJamez\",\n      \"type\": \"primary\"\n    }\n  ],\n  \"Products\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.royalti.io/asset")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Midnight City\",\n  \"mainArtist\": [\n    \"M83\",\n    \"M47\"\n  ],\n  \"displayArtist\": \"M83\",\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"otherArtist\": [\n    \"Featured Artist\"\n  ],\n  \"type\": \"Audio\",\n  \"version\": \"Album Version\",\n  \"isrc\": \"USRC17607839\",\n  \"iswc\": \"T-123456789-0\",\n  \"lyrics\": \"Waiting in a car...\",\n  \"mainGenre\": [\n    \"Electronic\",\n    \"Synthpop\"\n  ],\n  \"subGenre\": [\n    \"Synthwave\"\n  ],\n  \"contributors\": {\n    \"producers\": [\n      \"Producer Name\"\n    ],\n    \"mixers\": [\n      \"Mixer Name\"\n    ],\n    \"songwriters\": [\n      \"Songwriter Name\"\n    ]\n  },\n  \"externalId\": \"EXT-12345\",\n  \"extra\": {\n    \"notes\": \"Recorded in Abbey Road Studios\"\n  },\n  \"metadata\": {\n    \"releaseYear\": 2011\n  },\n  \"assetIDs\": [\n    \"asset-1\",\n    \"asset-2\"\n  ],\n  \"explicit\": \"clean\",\n  \"label\": \"Royalti Records\",\n  \"copyright\": \"© 2024 Royalti Records\",\n  \"publisher\": \"Royalti Publishing\",\n  \"copyrightOwner\": \"Royalti Music Group\",\n  \"artists\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"type\": \"primary\"\n    },\n    \"660e8400-e29b-41d4-a716-446655440001\"\n  ],\n  \"split\": [\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440002\",\n      \"share\": 60\n    },\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440003\",\n      \"share\": 40\n    }\n  ],\n  \"ddexMetadata\": {\n    \"releaseType\": \"Single\",\n    \"recordLabel\": \"Royalti Records\"\n  },\n  \"resourceReference\": \"SR123456789\",\n  \"technicalResourceDetails\": {\n    \"fileFormat\": \"WAV\",\n    \"audioCodec\": \"PCM\",\n    \"bitrate\": 1411,\n    \"sampleRate\": 44100,\n    \"duration\": \"PT3M45S\"\n  },\n  \"soundRecordingDetails\": {\n    \"recordingDate\": \"2024-01-15\",\n    \"recordingLocation\": \"Abbey Road Studios\",\n    \"language\": \"en\"\n  },\n  \"musicalWorkReference\": {\n    \"workId\": \"work-123\",\n    \"iswc\": \"T-123456789-0\"\n  },\n  \"enableDDEX\": false,\n  \"focusTrack\": false,\n  \"danceStyle\": [\n    \"Electronic Dance\"\n  ],\n  \"rhythmStyle\": [\n    \"Upbeat\"\n  ],\n  \"instrumentation\": [\n    \"Synthesizer\",\n    \"Drums\"\n  ],\n  \"recordingLocation\": \"Abbey Road Studios\",\n  \"recordingDate\": \"2024-01-15\",\n  \"alternativeTitles\": [\n    \"Alt Title 1\",\n    \"Alt Title 2\"\n  ],\n  \"chartPositions\": [\n    {\n      \"chart\": \"Billboard Hot 100\",\n      \"position\": 10,\n      \"date\": \"2024-01-01\"\n    }\n  ],\n  \"reviews\": [\n    {\n      \"reviewer\": \"Music Magazine\",\n      \"rating\": 4.5,\n      \"text\": \"Great track!\"\n    }\n  ],\n  \"awards\": [\n    {\n      \"name\": \"Best Electronic Song\",\n      \"year\": 2024\n    }\n  ],\n  \"socialMediaHandles\": {\n    \"twitter\": \"@artistname\",\n    \"instagram\": \"@artistname\"\n  },\n  \"language\": \"en\",\n  \"mood\": [\n    \"Energetic\",\n    \"Uplifting\"\n  ],\n  \"tempo\": 128,\n  \"key\": \"C Major\",\n  \"productionYear\": 2024,\n  \"createdAt\": \"2026-01-15T02:52:25.458Z\",\n  \"updatedAt\": \"2026-01-15T03:48:31.763Z\",\n  \"Artists\": [\n    {\n      \"id\": \"e0dc6000-af34-4071-8a85-dcadace05c36\",\n      \"artistName\": \"nedJamez\",\n      \"type\": \"primary\"\n    }\n  ],\n  \"Products\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.royalti.io/asset")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Midnight City\",\n  \"mainArtist\": [\n    \"M83\",\n    \"M47\"\n  ],\n  \"displayArtist\": \"M83\",\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"otherArtist\": [\n    \"Featured Artist\"\n  ],\n  \"type\": \"Audio\",\n  \"version\": \"Album Version\",\n  \"isrc\": \"USRC17607839\",\n  \"iswc\": \"T-123456789-0\",\n  \"lyrics\": \"Waiting in a car...\",\n  \"mainGenre\": [\n    \"Electronic\",\n    \"Synthpop\"\n  ],\n  \"subGenre\": [\n    \"Synthwave\"\n  ],\n  \"contributors\": {\n    \"producers\": [\n      \"Producer Name\"\n    ],\n    \"mixers\": [\n      \"Mixer Name\"\n    ],\n    \"songwriters\": [\n      \"Songwriter Name\"\n    ]\n  },\n  \"externalId\": \"EXT-12345\",\n  \"extra\": {\n    \"notes\": \"Recorded in Abbey Road Studios\"\n  },\n  \"metadata\": {\n    \"releaseYear\": 2011\n  },\n  \"assetIDs\": [\n    \"asset-1\",\n    \"asset-2\"\n  ],\n  \"explicit\": \"clean\",\n  \"label\": \"Royalti Records\",\n  \"copyright\": \"© 2024 Royalti Records\",\n  \"publisher\": \"Royalti Publishing\",\n  \"copyrightOwner\": \"Royalti Music Group\",\n  \"artists\": [\n    {\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"type\": \"primary\"\n    },\n    \"660e8400-e29b-41d4-a716-446655440001\"\n  ],\n  \"split\": [\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440002\",\n      \"share\": 60\n    },\n    {\n      \"user\": \"550e8400-e29b-41d4-a716-446655440003\",\n      \"share\": 40\n    }\n  ],\n  \"ddexMetadata\": {\n    \"releaseType\": \"Single\",\n    \"recordLabel\": \"Royalti Records\"\n  },\n  \"resourceReference\": \"SR123456789\",\n  \"technicalResourceDetails\": {\n    \"fileFormat\": \"WAV\",\n    \"audioCodec\": \"PCM\",\n    \"bitrate\": 1411,\n    \"sampleRate\": 44100,\n    \"duration\": \"PT3M45S\"\n  },\n  \"soundRecordingDetails\": {\n    \"recordingDate\": \"2024-01-15\",\n    \"recordingLocation\": \"Abbey Road Studios\",\n    \"language\": \"en\"\n  },\n  \"musicalWorkReference\": {\n    \"workId\": \"work-123\",\n    \"iswc\": \"T-123456789-0\"\n  },\n  \"enableDDEX\": false,\n  \"focusTrack\": false,\n  \"danceStyle\": [\n    \"Electronic Dance\"\n  ],\n  \"rhythmStyle\": [\n    \"Upbeat\"\n  ],\n  \"instrumentation\": [\n    \"Synthesizer\",\n    \"Drums\"\n  ],\n  \"recordingLocation\": \"Abbey Road Studios\",\n  \"recordingDate\": \"2024-01-15\",\n  \"alternativeTitles\": [\n    \"Alt Title 1\",\n    \"Alt Title 2\"\n  ],\n  \"chartPositions\": [\n    {\n      \"chart\": \"Billboard Hot 100\",\n      \"position\": 10,\n      \"date\": \"2024-01-01\"\n    }\n  ],\n  \"reviews\": [\n    {\n      \"reviewer\": \"Music Magazine\",\n      \"rating\": 4.5,\n      \"text\": \"Great track!\"\n    }\n  ],\n  \"awards\": [\n    {\n      \"name\": \"Best Electronic Song\",\n      \"year\": 2024\n    }\n  ],\n  \"socialMediaHandles\": {\n    \"twitter\": \"@artistname\",\n    \"instagram\": \"@artistname\"\n  },\n  \"language\": \"en\",\n  \"mood\": [\n    \"Energetic\",\n    \"Uplifting\"\n  ],\n  \"tempo\": 128,\n  \"key\": \"C Major\",\n  \"productionYear\": 2024,\n  \"createdAt\": \"2026-01-15T02:52:25.458Z\",\n  \"updatedAt\": \"2026-01-15T03:48:31.763Z\",\n  \"Artists\": [\n    {\n      \"id\": \"e0dc6000-af34-4071-8a85-dcadace05c36\",\n      \"artistName\": \"nedJamez\",\n      \"type\": \"primary\"\n    }\n  ],\n  \"Products\": []\n}"

response = http.request(request)
puts response.read_body

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Example Song",
  "type": "Audio",
  "ddexMetadata": null,
  "focusTrack": false,
  "media": [],
  "explicit": null,
  "mainArtist": [
    "M83",
    "M47"
  ],
  "displayArtist": "M83",
  "version": "Album Version",
  "mainGenre": [
    "Electronic",
    "Mental"
  ],
  "subGenre": [
    "Synthwave"
  ],
  "contributors": {
    "producers": [
      "Producer Name"
    ],
    "mixers": [
      "Mixer Name"
    ]
  },
  "iswc": "T-123456789-0",
  "externalId": "EXT-12345",
  "isrc": "USRC17607839",
  "updatedAt": "2025-08-21T11:42:29.827Z",
  "createdAt": "2025-08-21T11:42:29.827Z",
  "assetIDs": null,
  "otherArtist": null,
  "lyrics": null,
  "extra": null,
  "danceStyle": null,
  "rhythmStyle": null,
  "instrumentation": null,
  "recordingLocation": null,
  "recordingDate": null,
  "alternativeTitles": null,
  "chartPositions": null,
  "reviews": null,
  "awards": null,
  "socialMediaHandles": null,
  "language": null,
  "mood": null,
  "tempo": null,
  "key": null,
  "copyrightOwner": null,
  "productionYear": null,
  "metadata": null
}

{
  "status": "error",
  "message": "Invalid request parameters"
}

{
  "status": "error",
  "message": "Unauthorized"
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": [
      "<string>"
    ]
  }
}

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

Description

Authorization:

Required role: admin or higher

Required Fields:

Parameter	Type	Description
title (Required)	string	Title of the asset
mainArtist (Required)	array	Main artist of the asset
displayArtist (Required)	string	Display artist of the asset
type (Required)	string	Type of the asset (default: ‘Audio’)

Optional Fields:

Parameter	Type	Description
id (Optional)	string	ID of the asset
otherArtist (Optional)	array	Other artist of the asset
version (Optional)	string	Version of the asset
lyrics (Optional)	string	Lyrics of the asset
mainGenre (Optional)	array	Main genre of the asset
subGenre (Optional)	array	Sub genre of the asset
contributors (Optional)	object	Contributors of the asset
iswc (Optional)	string	ISWC of the asset
isrc (Optional))	string	ISRC of the asset
externalId (Optional)	string	External ID of the asset
extra (Optional)	object	Extra information of the asset
metadata (Optional)	object	Metadata of the asset
assetIDs (Optional)	array	Asset IDs of the asset
explicit (Optional)	boolean	Explicit content of the asset

DDEX Fields:

Parameter	Type	Description
ddexMetadata (Optional)	object	DDEX metadata of the asset
resourceReference (Optional)	string	Resource reference of the asset
technicalResourceDetails (Optional)	object	Technical resource details of the asset
soundRecordingDetails (Optional)	object	Sound recording details of the asset
musicalWorkReference (Optional)	object	Musical work reference of the asset

Other Fields:

Parameter	Type	Description
artists (Optional)	array	Artists of the asset
split (Optional)	array	Splits of the asset

Asset will be created with an ISRC which can be provided or auto-generated based on tenant settings.

Code Examples

const response = await fetch('https://api.royalti.io/asset', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "ref": "#/components/schemas/Asset"
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
  'https://api.royalti.io/asset',
  headers={
    'Authorization': f'Bearer {token}'
  },
  json={"ref":"#/components/schemas/Asset"}
)

data = response.json()
print(data)

curl -X POST https://api.royalti.io/asset \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ref":"#/components/schemas/Asset"}'

Authorizations

Authorization

string

header

required

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

Body

application/json

title

string

required

Title of the asset

Example:

"Midnight City"

mainArtist

string[]

required

Main artist name(s) for the asset (display purposes). Note: This is an array of artist NAMES (strings), not UUIDs. For creating artist associations/relationships, use the 'artists' field with UUIDs.

Example:

["M83", "M47"]

displayArtist

string

required

Display name for the lead artist (single string representation)

Maximum string length: 510

Example:

"M83"

string<uuid>

Pre-generated UUID (optional, rarely used)

Example:

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

otherArtist

string[]

Featured artist name(s) in the asset (display purposes). These are artist NAMES (strings), not UUIDs.

Example:

["Featured Artist"]

type

enum<string>

default:Audio

Type of asset

Available options:

Audio,

Video,

Ringtone,

YouTube

Example:

"Audio"

version

string

Version of the asset (e.g., Remix, Live Version)

Example:

"Album Version"

isrc

string

International Standard Recording Code (auto-generated if not provided)

Pattern: ^[A-Z]{2}[A-Z0-9]{3}[0-9]{2}[0-9]{5}$

Example:

"USRC17607839"

iswc

string

International Standard Musical Work Code

Pattern: ^T-\d{9}-\d$

Example:

"T-123456789-0"

lyrics

string

Lyrics of the asset

Example:

"Waiting in a car..."

mainGenre

string[]

Main genre(s) of the asset

Example:

["Electronic", "Synthpop"]

subGenre

string[]

Sub-genre(s) of the asset

Example:

["Synthwave"]

contributors

object

Contributors to the asset (producers, mixers, songwriters, etc.). Accepts two formats:

Object format: { "producers": ["Name1", "Name2"], "songwriters": ["Name3"] }

Array format: [{ "name": "Name1", "role": "producer" }, { "name": "Name2", "role": "songwriter" }]

The array format is automatically transformed to object format internally.

Supported roles: producer, songwriter, composer, lyricist, mixer, engineer, arranger, masteringengineer, remixer (singular or plural forms accepted). Custom roles are also supported.

object
object[]

Show child attributes

Example:

{
  "producers": ["Producer Name"],
  "mixers": ["Mixer Name"],
  "songwriters": ["Songwriter Name"]
}

externalId

string

External identifier for the asset

Example:

"EXT-12345"

extra

object

Additional metadata about the asset

Example:

{ "notes": "Recorded in Abbey Road Studios" }

metadata

object

General metadata for the asset

Example:

{ "releaseYear": 2011 }

assetIDs

string[]

Array of individual asset IDs (for album assets)

Example:

["asset-1", "asset-2"]

explicit

enum<string>

Explicit content flag

Available options:

explicit,

clean

Example:

"clean"

label

string

Record label

Example:

"Royalti Records"

string

Example:

publisher

string

Publisher name

Example:

"Royalti Publishing"

copyrightOwner

string

Example:

"Royalti Music Group"

artists

(string<uuid> | object)[]

Artist associations for creating relational links in the database. Note: This field uses artist record UUIDs (not names) to create entries in the ArtistAsset join table. This is separate from 'mainArtist' which stores artist names for display. Can be either:

Array of UUID strings: ["uuid1", "uuid2"]
Array of objects with id and type: [{id: "uuid1", type: "primary"}]

Artist UUID (defaults to type 'primary')

Example:

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "primary"
  },
  "660e8400-e29b-41d4-a716-446655440001"
]

split

object[]

Revenue split configuration (must total 100%)

Show child attributes

Example:

[
  {
    "user": "550e8400-e29b-41d4-a716-446655440002",
    "share": 60
  },
  {
    "user": "550e8400-e29b-41d4-a716-446655440003",
    "share": 40
  }
]

ddexMetadata

object

DDEX-specific metadata

Example:

{
  "releaseType": "Single",
  "recordLabel": "Royalti Records"
}

resourceReference

string

DDEX resource reference (auto-generated if DDEX enabled but not provided)

Example:

"SR123456789"

technicalResourceDetails

object

Technical details of the resource

Show child attributes

soundRecordingDetails

object

Sound recording specific details

Show child attributes

musicalWorkReference

object

Musical work reference information

Show child attributes

enableDDEX

boolean

Enable DDEX for this asset

Example:

false

focusTrack

boolean

default:false

Whether this is a focus track for MEAD

Example:

false

danceStyle

string[]

Dance style(s) for MEAD

Example:

["Electronic Dance"]

rhythmStyle

string[]

Rhythm style(s) for MEAD

Example:

["Upbeat"]

instrumentation

string[]

Instrumentation for MEAD

Example:

["Synthesizer", "Drums"]

recordingLocation

string

Recording location

Maximum string length: 255

Example:

"Abbey Road Studios"

recordingDate

string<date>

Recording date

Example:

"2024-01-15"

alternativeTitles

string[]

Alternative titles for the asset

Example:

["Alt Title 1", "Alt Title 2"]

chartPositions

object[]

Chart positions

Example:

[
  {
    "chart": "Billboard Hot 100",
    "position": 10,
    "date": "2024-01-01"
  }
]

reviews

object[]

Reviews of the asset

Example:

[
  {
    "reviewer": "Music Magazine",
    "rating": 4.5,
    "text": "Great track!"
  }
]

awards

object[]

Awards received

Example:

[
  {
    "name": "Best Electronic Song",
    "year": 2024
  }
]

Social media handles

Show child attributes

Example:

{
  "twitter": "@artistname",
  "instagram": "@artistname"
}

language

string

Language of the asset

Example:

"en"

mood

string[]

Mood of the asset

Example:

["Energetic", "Uplifting"]

tempo

number

Tempo in BPM

Example:

128

key

string

Musical key

Example:

"C Major"

productionYear

integer

Year of production

Example:

2024

createdAt

string<date-time>

Timestamp when the asset was created

Example:

"2026-01-15T02:52:25.458Z"

updatedAt

string<date-time>

Timestamp when the asset was last updated

Example:

"2026-01-15T03:48:31.763Z"

Artists

object[]

Associated artists with their relationship type

Show child attributes

Example:

[
  {
    "id": "e0dc6000-af34-4071-8a85-dcadace05c36",
    "artistName": "nedJamez",
    "type": "primary"
  }
]

Products

object[]

Associated products (albums, EPs, singles)

Show child attributes

Example:

[]

Response

Asset created successfully - Returns the asset object directly

title

string

required

Title of the asset

Example:

"Midnight City"

mainArtist

string[]

required

Main artist name(s) for the asset (display purposes). Note: This is an array of artist NAMES (strings), not UUIDs. For creating artist associations/relationships, use the 'artists' field with UUIDs.

Example:

["M83", "M47"]

displayArtist

string

required

Display name for the lead artist (single string representation)

Maximum string length: 510

Example:

"M83"

string<uuid>

Pre-generated UUID (optional, rarely used)

Example:

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

otherArtist

string[]

Featured artist name(s) in the asset (display purposes). These are artist NAMES (strings), not UUIDs.

Example:

["Featured Artist"]

type

enum<string>

default:Audio

Type of asset

Available options:

Audio,

Video,

Ringtone,

YouTube

Example:

"Audio"

version

string

Version of the asset (e.g., Remix, Live Version)

Example:

"Album Version"

isrc

string

International Standard Recording Code (auto-generated if not provided)

Pattern: ^[A-Z]{2}[A-Z0-9]{3}[0-9]{2}[0-9]{5}$

Example:

"USRC17607839"

iswc

string

International Standard Musical Work Code

Pattern: ^T-\d{9}-\d$

Example:

"T-123456789-0"

lyrics

string

Lyrics of the asset

Example:

"Waiting in a car..."

mainGenre

string[]

Main genre(s) of the asset

Example:

["Electronic", "Synthpop"]

subGenre

string[]

Sub-genre(s) of the asset

Example:

["Synthwave"]

contributors

object

Contributors to the asset (producers, mixers, songwriters, etc.). Accepts two formats:

Object format: { "producers": ["Name1", "Name2"], "songwriters": ["Name3"] }

Array format: [{ "name": "Name1", "role": "producer" }, { "name": "Name2", "role": "songwriter" }]

The array format is automatically transformed to object format internally.

Supported roles: producer, songwriter, composer, lyricist, mixer, engineer, arranger, masteringengineer, remixer (singular or plural forms accepted). Custom roles are also supported.

object
object[]

Show child attributes

Example:

{
  "producers": ["Producer Name"],
  "mixers": ["Mixer Name"],
  "songwriters": ["Songwriter Name"]
}

externalId

string

External identifier for the asset

Example:

"EXT-12345"

extra

object

Additional metadata about the asset

Example:

{ "notes": "Recorded in Abbey Road Studios" }

metadata

object

General metadata for the asset

Example:

{ "releaseYear": 2011 }

assetIDs

string[]

Array of individual asset IDs (for album assets)

Example:

["asset-1", "asset-2"]

explicit

enum<string>

Explicit content flag

Available options:

explicit,

clean

Example:

"clean"

label

string

Record label

Example:

"Royalti Records"

string

Example:

publisher

string

Publisher name

Example:

"Royalti Publishing"

copyrightOwner

string

Example:

"Royalti Music Group"

artists

(string<uuid> | object)[]

Array of UUID strings: ["uuid1", "uuid2"]
Array of objects with id and type: [{id: "uuid1", type: "primary"}]

Artist UUID (defaults to type 'primary')

Example:

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "primary"
  },
  "660e8400-e29b-41d4-a716-446655440001"
]

split

object[]

Revenue split configuration (must total 100%)

Show child attributes

Example:

[
  {
    "user": "550e8400-e29b-41d4-a716-446655440002",
    "share": 60
  },
  {
    "user": "550e8400-e29b-41d4-a716-446655440003",
    "share": 40
  }
]

ddexMetadata

object

DDEX-specific metadata

Example:

{
  "releaseType": "Single",
  "recordLabel": "Royalti Records"
}

resourceReference

string

DDEX resource reference (auto-generated if DDEX enabled but not provided)

Example:

"SR123456789"

technicalResourceDetails

object

Technical details of the resource

Show child attributes

soundRecordingDetails

object

Sound recording specific details

Show child attributes

musicalWorkReference

object

Musical work reference information

Show child attributes

enableDDEX

boolean

Enable DDEX for this asset

Example:

false

focusTrack

boolean

default:false

Whether this is a focus track for MEAD

Example:

false

danceStyle

string[]

Dance style(s) for MEAD

Example:

["Electronic Dance"]

rhythmStyle

string[]

Rhythm style(s) for MEAD

Example:

["Upbeat"]

instrumentation

string[]

Instrumentation for MEAD

Example:

["Synthesizer", "Drums"]

recordingLocation

string

Recording location

Maximum string length: 255

Example:

"Abbey Road Studios"

recordingDate

string<date>

Recording date

Example:

"2024-01-15"

alternativeTitles

string[]

Alternative titles for the asset

Example:

["Alt Title 1", "Alt Title 2"]

chartPositions

object[]

Chart positions

Example:

[
  {
    "chart": "Billboard Hot 100",
    "position": 10,
    "date": "2024-01-01"
  }
]

reviews

object[]

Reviews of the asset

Example:

[
  {
    "reviewer": "Music Magazine",
    "rating": 4.5,
    "text": "Great track!"
  }
]

awards

object[]

Awards received

Example:

[
  {
    "name": "Best Electronic Song",
    "year": 2024
  }
]

Social media handles

Show child attributes

Example:

{
  "twitter": "@artistname",
  "instagram": "@artistname"
}

language

string

Language of the asset

Example:

"en"

mood

string[]

Mood of the asset

Example:

["Energetic", "Uplifting"]

tempo

number

Tempo in BPM

Example:

128

key

string

Musical key

Example:

"C Major"

productionYear

integer

Year of production

Example:

2024

createdAt

string<date-time>

Timestamp when the asset was created

Example:

"2026-01-15T02:52:25.458Z"

updatedAt

string<date-time>

Timestamp when the asset was last updated

Example:

"2026-01-15T03:48:31.763Z"

Artists

object[]

Associated artists with their relationship type

Show child attributes

Example:

[
  {
    "id": "e0dc6000-af34-4071-8a85-dcadace05c36",
    "artistName": "nedJamez",
    "type": "primary"
  }
]

Products

object[]

Associated products (albums, EPs, singles)

Show child attributes

Example:

[]

​Description

​Code Examples

Authorizations

Body

Response

Description

Code Examples