Create Artist
curl --request POST \
--url https://api.royalti.io/artist/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"artistName": "testArtist",
"signDate": "2022-01-21",
"externalId": "1rema45",
"label": "Mavins Records",
"copyright": "mavins global jonzing world",
"publisher": "mavings global",
"contributors": [
{
"name": "contributor 1",
"role": "composer"
},
{
"name": "contributor 2",
"role": "producer"
}
],
"links": {
"website": "https://remamavins.com/",
"twitter": "https://twitter.com/taremamavins",
"instagram": "https://www.instagram.com/remamavins/",
"facebook": "https://www.facebook.com/remamavins",
"youtube": "https://www.youtube.com/remamavins"
},
"users": [
"91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
"9ea08acc-e135-4bd9-b159-48339ff65061",
"b369dabe-b4e0-4787-91a5-b561c98601e5"
],
"split": [
{
"user": "91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
"share": 30
},
{
"user": "9ea08acc-e135-4bd9-b159-48339ff65061",
"share": 50
},
{
"user": "b369dabe-b4e0-4787-91a5-b561c98601e5",
"share": 20
}
]
}
'import requests
url = "https://api.royalti.io/artist/"
payload = {
"artistName": "testArtist",
"signDate": "2022-01-21",
"externalId": "1rema45",
"label": "Mavins Records",
"copyright": "mavins global jonzing world",
"publisher": "mavings global",
"contributors": [
{
"name": "contributor 1",
"role": "composer"
},
{
"name": "contributor 2",
"role": "producer"
}
],
"links": {
"website": "https://remamavins.com/",
"twitter": "https://twitter.com/taremamavins",
"instagram": "https://www.instagram.com/remamavins/",
"facebook": "https://www.facebook.com/remamavins",
"youtube": "https://www.youtube.com/remamavins"
},
"users": ["91f1d1bd-ef25-4990-bd4f-aeee696c73a9", "9ea08acc-e135-4bd9-b159-48339ff65061", "b369dabe-b4e0-4787-91a5-b561c98601e5"],
"split": [
{
"user": "91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
"share": 30
},
{
"user": "9ea08acc-e135-4bd9-b159-48339ff65061",
"share": 50
},
{
"user": "b369dabe-b4e0-4787-91a5-b561c98601e5",
"share": 20
}
]
}
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({
artistName: 'testArtist',
signDate: '2022-01-21',
externalId: '1rema45',
label: 'Mavins Records',
copyright: 'mavins global jonzing world',
publisher: 'mavings global',
contributors: [
{name: 'contributor 1', role: 'composer'},
{name: 'contributor 2', role: 'producer'}
],
links: {
website: 'https://remamavins.com/',
twitter: 'https://twitter.com/taremamavins',
instagram: 'https://www.instagram.com/remamavins/',
facebook: 'https://www.facebook.com/remamavins',
youtube: 'https://www.youtube.com/remamavins'
},
users: [
'91f1d1bd-ef25-4990-bd4f-aeee696c73a9',
'9ea08acc-e135-4bd9-b159-48339ff65061',
'b369dabe-b4e0-4787-91a5-b561c98601e5'
],
split: [
{user: '91f1d1bd-ef25-4990-bd4f-aeee696c73a9', share: 30},
{user: '9ea08acc-e135-4bd9-b159-48339ff65061', share: 50},
{user: 'b369dabe-b4e0-4787-91a5-b561c98601e5', share: 20}
]
})
};
fetch('https://api.royalti.io/artist/', 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/artist/",
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([
'artistName' => 'testArtist',
'signDate' => '2022-01-21',
'externalId' => '1rema45',
'label' => 'Mavins Records',
'copyright' => 'mavins global jonzing world',
'publisher' => 'mavings global',
'contributors' => [
[
'name' => 'contributor 1',
'role' => 'composer'
],
[
'name' => 'contributor 2',
'role' => 'producer'
]
],
'links' => [
'website' => 'https://remamavins.com/',
'twitter' => 'https://twitter.com/taremamavins',
'instagram' => 'https://www.instagram.com/remamavins/',
'facebook' => 'https://www.facebook.com/remamavins',
'youtube' => 'https://www.youtube.com/remamavins'
],
'users' => [
'91f1d1bd-ef25-4990-bd4f-aeee696c73a9',
'9ea08acc-e135-4bd9-b159-48339ff65061',
'b369dabe-b4e0-4787-91a5-b561c98601e5'
],
'split' => [
[
'user' => '91f1d1bd-ef25-4990-bd4f-aeee696c73a9',
'share' => 30
],
[
'user' => '9ea08acc-e135-4bd9-b159-48339ff65061',
'share' => 50
],
[
'user' => 'b369dabe-b4e0-4787-91a5-b561c98601e5',
'share' => 20
]
]
]),
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/artist/"
payload := strings.NewReader("{\n \"artistName\": \"testArtist\",\n \"signDate\": \"2022-01-21\",\n \"externalId\": \"1rema45\",\n \"label\": \"Mavins Records\",\n \"copyright\": \"mavins global jonzing world\",\n \"publisher\": \"mavings global\",\n \"contributors\": [\n {\n \"name\": \"contributor 1\",\n \"role\": \"composer\"\n },\n {\n \"name\": \"contributor 2\",\n \"role\": \"producer\"\n }\n ],\n \"links\": {\n \"website\": \"https://remamavins.com/\",\n \"twitter\": \"https://twitter.com/taremamavins\",\n \"instagram\": \"https://www.instagram.com/remamavins/\",\n \"facebook\": \"https://www.facebook.com/remamavins\",\n \"youtube\": \"https://www.youtube.com/remamavins\"\n },\n \"users\": [\n \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"b369dabe-b4e0-4787-91a5-b561c98601e5\"\n ],\n \"split\": [\n {\n \"user\": \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"share\": 30\n },\n {\n \"user\": \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"share\": 50\n },\n {\n \"user\": \"b369dabe-b4e0-4787-91a5-b561c98601e5\",\n \"share\": 20\n }\n ]\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/artist/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"artistName\": \"testArtist\",\n \"signDate\": \"2022-01-21\",\n \"externalId\": \"1rema45\",\n \"label\": \"Mavins Records\",\n \"copyright\": \"mavins global jonzing world\",\n \"publisher\": \"mavings global\",\n \"contributors\": [\n {\n \"name\": \"contributor 1\",\n \"role\": \"composer\"\n },\n {\n \"name\": \"contributor 2\",\n \"role\": \"producer\"\n }\n ],\n \"links\": {\n \"website\": \"https://remamavins.com/\",\n \"twitter\": \"https://twitter.com/taremamavins\",\n \"instagram\": \"https://www.instagram.com/remamavins/\",\n \"facebook\": \"https://www.facebook.com/remamavins\",\n \"youtube\": \"https://www.youtube.com/remamavins\"\n },\n \"users\": [\n \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"b369dabe-b4e0-4787-91a5-b561c98601e5\"\n ],\n \"split\": [\n {\n \"user\": \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"share\": 30\n },\n {\n \"user\": \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"share\": 50\n },\n {\n \"user\": \"b369dabe-b4e0-4787-91a5-b561c98601e5\",\n \"share\": 20\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.royalti.io/artist/")
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 \"artistName\": \"testArtist\",\n \"signDate\": \"2022-01-21\",\n \"externalId\": \"1rema45\",\n \"label\": \"Mavins Records\",\n \"copyright\": \"mavins global jonzing world\",\n \"publisher\": \"mavings global\",\n \"contributors\": [\n {\n \"name\": \"contributor 1\",\n \"role\": \"composer\"\n },\n {\n \"name\": \"contributor 2\",\n \"role\": \"producer\"\n }\n ],\n \"links\": {\n \"website\": \"https://remamavins.com/\",\n \"twitter\": \"https://twitter.com/taremamavins\",\n \"instagram\": \"https://www.instagram.com/remamavins/\",\n \"facebook\": \"https://www.facebook.com/remamavins\",\n \"youtube\": \"https://www.youtube.com/remamavins\"\n },\n \"users\": [\n \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"b369dabe-b4e0-4787-91a5-b561c98601e5\"\n ],\n \"split\": [\n {\n \"user\": \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"share\": 30\n },\n {\n \"user\": \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"share\": 50\n },\n {\n \"user\": \"b369dabe-b4e0-4787-91a5-b561c98601e5\",\n \"share\": 20\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "2fca1b81-2f97-4b02-92a2-899d17c756b8",
"artistName": "alobammm",
"signDate": "2025-01-12T00:00:00.000Z",
"label": "Mavins Records",
"externalId": "1rema45",
"copyright": "mavins global jonzing world",
"publisher": "mavings global",
"links": {
"website": "https://remamavins.com/",
"twitter": "https://twitter.com/taremamavins",
"instagram": "https://www.instagram.com/remamavins/",
"facebook": "https://www.facebook.com/remamavins",
"youtube": "https://www.youtube.com/remamavins"
},
"contributors": [
{
"name": "contributor 1",
"role": "composer"
},
{
"name": "contributor 2",
"role": "producer"
}
],
"TenantId": 2,
"createdAt": "2025-01-21T14:30:00.000Z",
"updatedAt": "2025-01-21T14:30:00.000Z"
}{
"status": "error",
"message": "Invalid request parameters"
}{
"status": "error",
"message": "Unauthorized"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": [
"<string>"
]
}
}{
"status": "error",
"message": "Resource not found"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": [
"<string>"
]
}
}Artist
Create Artist
artist/
POST
/
artist
/
Create Artist
curl --request POST \
--url https://api.royalti.io/artist/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"artistName": "testArtist",
"signDate": "2022-01-21",
"externalId": "1rema45",
"label": "Mavins Records",
"copyright": "mavins global jonzing world",
"publisher": "mavings global",
"contributors": [
{
"name": "contributor 1",
"role": "composer"
},
{
"name": "contributor 2",
"role": "producer"
}
],
"links": {
"website": "https://remamavins.com/",
"twitter": "https://twitter.com/taremamavins",
"instagram": "https://www.instagram.com/remamavins/",
"facebook": "https://www.facebook.com/remamavins",
"youtube": "https://www.youtube.com/remamavins"
},
"users": [
"91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
"9ea08acc-e135-4bd9-b159-48339ff65061",
"b369dabe-b4e0-4787-91a5-b561c98601e5"
],
"split": [
{
"user": "91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
"share": 30
},
{
"user": "9ea08acc-e135-4bd9-b159-48339ff65061",
"share": 50
},
{
"user": "b369dabe-b4e0-4787-91a5-b561c98601e5",
"share": 20
}
]
}
'import requests
url = "https://api.royalti.io/artist/"
payload = {
"artistName": "testArtist",
"signDate": "2022-01-21",
"externalId": "1rema45",
"label": "Mavins Records",
"copyright": "mavins global jonzing world",
"publisher": "mavings global",
"contributors": [
{
"name": "contributor 1",
"role": "composer"
},
{
"name": "contributor 2",
"role": "producer"
}
],
"links": {
"website": "https://remamavins.com/",
"twitter": "https://twitter.com/taremamavins",
"instagram": "https://www.instagram.com/remamavins/",
"facebook": "https://www.facebook.com/remamavins",
"youtube": "https://www.youtube.com/remamavins"
},
"users": ["91f1d1bd-ef25-4990-bd4f-aeee696c73a9", "9ea08acc-e135-4bd9-b159-48339ff65061", "b369dabe-b4e0-4787-91a5-b561c98601e5"],
"split": [
{
"user": "91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
"share": 30
},
{
"user": "9ea08acc-e135-4bd9-b159-48339ff65061",
"share": 50
},
{
"user": "b369dabe-b4e0-4787-91a5-b561c98601e5",
"share": 20
}
]
}
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({
artistName: 'testArtist',
signDate: '2022-01-21',
externalId: '1rema45',
label: 'Mavins Records',
copyright: 'mavins global jonzing world',
publisher: 'mavings global',
contributors: [
{name: 'contributor 1', role: 'composer'},
{name: 'contributor 2', role: 'producer'}
],
links: {
website: 'https://remamavins.com/',
twitter: 'https://twitter.com/taremamavins',
instagram: 'https://www.instagram.com/remamavins/',
facebook: 'https://www.facebook.com/remamavins',
youtube: 'https://www.youtube.com/remamavins'
},
users: [
'91f1d1bd-ef25-4990-bd4f-aeee696c73a9',
'9ea08acc-e135-4bd9-b159-48339ff65061',
'b369dabe-b4e0-4787-91a5-b561c98601e5'
],
split: [
{user: '91f1d1bd-ef25-4990-bd4f-aeee696c73a9', share: 30},
{user: '9ea08acc-e135-4bd9-b159-48339ff65061', share: 50},
{user: 'b369dabe-b4e0-4787-91a5-b561c98601e5', share: 20}
]
})
};
fetch('https://api.royalti.io/artist/', 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/artist/",
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([
'artistName' => 'testArtist',
'signDate' => '2022-01-21',
'externalId' => '1rema45',
'label' => 'Mavins Records',
'copyright' => 'mavins global jonzing world',
'publisher' => 'mavings global',
'contributors' => [
[
'name' => 'contributor 1',
'role' => 'composer'
],
[
'name' => 'contributor 2',
'role' => 'producer'
]
],
'links' => [
'website' => 'https://remamavins.com/',
'twitter' => 'https://twitter.com/taremamavins',
'instagram' => 'https://www.instagram.com/remamavins/',
'facebook' => 'https://www.facebook.com/remamavins',
'youtube' => 'https://www.youtube.com/remamavins'
],
'users' => [
'91f1d1bd-ef25-4990-bd4f-aeee696c73a9',
'9ea08acc-e135-4bd9-b159-48339ff65061',
'b369dabe-b4e0-4787-91a5-b561c98601e5'
],
'split' => [
[
'user' => '91f1d1bd-ef25-4990-bd4f-aeee696c73a9',
'share' => 30
],
[
'user' => '9ea08acc-e135-4bd9-b159-48339ff65061',
'share' => 50
],
[
'user' => 'b369dabe-b4e0-4787-91a5-b561c98601e5',
'share' => 20
]
]
]),
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/artist/"
payload := strings.NewReader("{\n \"artistName\": \"testArtist\",\n \"signDate\": \"2022-01-21\",\n \"externalId\": \"1rema45\",\n \"label\": \"Mavins Records\",\n \"copyright\": \"mavins global jonzing world\",\n \"publisher\": \"mavings global\",\n \"contributors\": [\n {\n \"name\": \"contributor 1\",\n \"role\": \"composer\"\n },\n {\n \"name\": \"contributor 2\",\n \"role\": \"producer\"\n }\n ],\n \"links\": {\n \"website\": \"https://remamavins.com/\",\n \"twitter\": \"https://twitter.com/taremamavins\",\n \"instagram\": \"https://www.instagram.com/remamavins/\",\n \"facebook\": \"https://www.facebook.com/remamavins\",\n \"youtube\": \"https://www.youtube.com/remamavins\"\n },\n \"users\": [\n \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"b369dabe-b4e0-4787-91a5-b561c98601e5\"\n ],\n \"split\": [\n {\n \"user\": \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"share\": 30\n },\n {\n \"user\": \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"share\": 50\n },\n {\n \"user\": \"b369dabe-b4e0-4787-91a5-b561c98601e5\",\n \"share\": 20\n }\n ]\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/artist/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"artistName\": \"testArtist\",\n \"signDate\": \"2022-01-21\",\n \"externalId\": \"1rema45\",\n \"label\": \"Mavins Records\",\n \"copyright\": \"mavins global jonzing world\",\n \"publisher\": \"mavings global\",\n \"contributors\": [\n {\n \"name\": \"contributor 1\",\n \"role\": \"composer\"\n },\n {\n \"name\": \"contributor 2\",\n \"role\": \"producer\"\n }\n ],\n \"links\": {\n \"website\": \"https://remamavins.com/\",\n \"twitter\": \"https://twitter.com/taremamavins\",\n \"instagram\": \"https://www.instagram.com/remamavins/\",\n \"facebook\": \"https://www.facebook.com/remamavins\",\n \"youtube\": \"https://www.youtube.com/remamavins\"\n },\n \"users\": [\n \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"b369dabe-b4e0-4787-91a5-b561c98601e5\"\n ],\n \"split\": [\n {\n \"user\": \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"share\": 30\n },\n {\n \"user\": \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"share\": 50\n },\n {\n \"user\": \"b369dabe-b4e0-4787-91a5-b561c98601e5\",\n \"share\": 20\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.royalti.io/artist/")
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 \"artistName\": \"testArtist\",\n \"signDate\": \"2022-01-21\",\n \"externalId\": \"1rema45\",\n \"label\": \"Mavins Records\",\n \"copyright\": \"mavins global jonzing world\",\n \"publisher\": \"mavings global\",\n \"contributors\": [\n {\n \"name\": \"contributor 1\",\n \"role\": \"composer\"\n },\n {\n \"name\": \"contributor 2\",\n \"role\": \"producer\"\n }\n ],\n \"links\": {\n \"website\": \"https://remamavins.com/\",\n \"twitter\": \"https://twitter.com/taremamavins\",\n \"instagram\": \"https://www.instagram.com/remamavins/\",\n \"facebook\": \"https://www.facebook.com/remamavins\",\n \"youtube\": \"https://www.youtube.com/remamavins\"\n },\n \"users\": [\n \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"b369dabe-b4e0-4787-91a5-b561c98601e5\"\n ],\n \"split\": [\n {\n \"user\": \"91f1d1bd-ef25-4990-bd4f-aeee696c73a9\",\n \"share\": 30\n },\n {\n \"user\": \"9ea08acc-e135-4bd9-b159-48339ff65061\",\n \"share\": 50\n },\n {\n \"user\": \"b369dabe-b4e0-4787-91a5-b561c98601e5\",\n \"share\": 20\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": "2fca1b81-2f97-4b02-92a2-899d17c756b8",
"artistName": "alobammm",
"signDate": "2025-01-12T00:00:00.000Z",
"label": "Mavins Records",
"externalId": "1rema45",
"copyright": "mavins global jonzing world",
"publisher": "mavings global",
"links": {
"website": "https://remamavins.com/",
"twitter": "https://twitter.com/taremamavins",
"instagram": "https://www.instagram.com/remamavins/",
"facebook": "https://www.facebook.com/remamavins",
"youtube": "https://www.youtube.com/remamavins"
},
"contributors": [
{
"name": "contributor 1",
"role": "composer"
},
{
"name": "contributor 2",
"role": "producer"
}
],
"TenantId": 2,
"createdAt": "2025-01-21T14:30:00.000Z",
"updatedAt": "2025-01-21T14:30:00.000Z"
}{
"status": "error",
"message": "Invalid request parameters"
}{
"status": "error",
"message": "Unauthorized"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": [
"<string>"
]
}
}{
"status": "error",
"message": "Resource not found"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": [
"<string>"
]
}
}This endpoint requires authentication. Include your Bearer token in the Authorization header.
Description
artist/ Description: The/artist/ endpoint allows the creation of a new artist profile by providing details such as artist name, sign date, label, external ID, links, associated users, and their respective split shares.
Authorization:
- Required role:
adminor higher
POST
Request Payload:
| Parameter | Type | Description | Required |
|---|---|---|---|
| artistName | string | The name of the artist. | Yes |
| signDate | date | The date the artist was signed. | Yes |
| label | string | The label associated with the artist. | No |
| copyright | string | The copyright information of the artist. | No |
| publisher | string | The publisher information of the artist. | No |
| contributors | array | An array of objects containing contributor names and roles. | Yes |
| externalId | string | The external ID of the artist. | Yes |
| links | object | Links to the artist’s website and social media profiles. | Yes |
| users | array | An array of user IDs associated with the artist. | Yes |
| split | array | An array of objects containing user IDs and their respective shares. | Yes |
See sample payload and response below
Code Examples
const response = await fetch('https://api.royalti.io/artist/', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"artistName": "sample-artistName",
"signDate": "2024-01-21",
"externalId": "sample-externalId",
"label": "sample-label",
"copyright": "sample-copyright",
"publisher": "sample-publisher",
"contributors": [
{
"name": "sample-name",
"role": "sample-role"
}
],
"links": {
"website": "sample-website",
"twitter": "sample-twitter",
"instagram": "sample-instagram",
"facebook": "sample-facebook",
"youtube": "sample-youtube"
},
"users": [
{}
],
"split": [
{
"user": "sample-user",
"share": 1
}
]
})
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
'https://api.royalti.io/artist/',
headers={
'Authorization': f'Bearer {token}'
},
json={"artistName":"sample-artistName","signDate":"2024-01-21","externalId":"sample-externalId","label":"sample-label","copyright":"sample-copyright","publisher":"sample-publisher","contributors":[{"name":"sample-name","role":"sample-role"}],"links":{"website":"sample-website","twitter":"sample-twitter","instagram":"sample-instagram","facebook":"sample-facebook","youtube":"sample-youtube"},"users":[{}],"split":[{"user":"sample-user","share":1}]}
)
data = response.json()
print(data)
curl -X POST https://api.royalti.io/artist/ \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"artistName":"sample-artistName","signDate":"2024-01-21","externalId":"sample-externalId","label":"sample-label","copyright":"sample-copyright","publisher":"sample-publisher","contributors":[{"name":"sample-name","role":"sample-role"}],"links":{"website":"sample-website","twitter":"sample-twitter","instagram":"sample-instagram","facebook":"sample-facebook","youtube":"sample-youtube"},"users":[{}],"split":[{"user":"sample-user","share":1}]}'
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Body
application/json
The name of the artist
The date the artist was signed
An array of user IDs associated with the artist
An array of objects containing user IDs and their respective shares
Show child attributes
Show child attributes
The external ID of the artist
The label associated with the artist
Copyright information
Publisher information
Contributors to the artist
Show child attributes
Show child attributes
Links to the artist's website and social media profiles
Show child attributes
Show child attributes
Response
Success
Unique identifier of the artist
Name of the artist
Date the artist was signed
Label associated with the artist
External ID of the artist
Copyright information
Publisher information
Social media and website links
Show child attributes
Show child attributes
Contributors to the artist
Show child attributes
Show child attributes
Tenant ID the artist belongs to
Timestamp of when the artist was created
Timestamp of when the artist was last updated
⌘I