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.
Method:
POST
Request Payload:
Parameter | Type | Description |
---|---|---|
artistName | string | The name of the artist. |
signDate | date | The date the artist was signed. |
label | string | The label associated with the artist. |
externalId | string | The external ID of the artist. |
links | object | Links to the artistās website and social media profiles. |
users | array | An array of user IDs associated with the artist. |
split | array | An array of objects containing user IDs and their respective shares. |
See sample payload and response below
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/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
}
]
}'
{
"message": "artist created successfully",
"artist": {
"id": "2fca1b81-2f97-4b02-92a2-899d17c756b8",
"artistName": "testArtist",
"signDate": "2022-01-21T00:00:00.000Z",
"label": "Mavins Records",
"externalId": "1rema45",
"TenantId": 2,
"createdAt": "2024-12-12T10:30:00.000Z",
"updatedAt": "2024-12-12T10:30:00.000Z"
}
}
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Success
The response is of type object
.
curl --request POST \
--url https://server26-dot-royalti-project.uc.r.appspot.com/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
}
]
}'
{
"message": "artist created successfully",
"artist": {
"id": "2fca1b81-2f97-4b02-92a2-899d17c756b8",
"artistName": "testArtist",
"signDate": "2022-01-21T00:00:00.000Z",
"label": "Mavins Records",
"externalId": "1rema45",
"TenantId": 2,
"createdAt": "2024-12-12T10:30:00.000Z",
"updatedAt": "2024-12-12T10:30:00.000Z"
}
}