Skip to main content
POST
/
artist
/
Create Artist
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"
  }
}
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:
ParameterTypeDescription
artistNamestringThe name of the artist.
signDatedateThe date the artist was signed.
labelstringThe label associated with the artist.
externalIdstringThe external ID of the artist.
linksobjectLinks to the artist’s website and social media profiles.
usersarrayAn array of user IDs associated with the artist.
splitarrayAn array of objects containing user IDs and their respective shares.
See sample payload and response below

Authentication

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

Request Body

Example Request

{
  "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
    }
  ]
}

Request Schema

FieldTypeRequiredDescription
artistNamestringThe name of the artist
signDatestringThe date the artist was signed
externalIdstringThe external ID of the artist
labelstringThe label associated with the artist
copyrightstringCopyright information
publisherstringPublisher information
contributorsarrayContributors to the artist
linksobjectLinks to the artist’s website and social media profiles
usersarrayAn array of user IDs associated with the artist
splitarrayAn array of objects containing user IDs and their respective shares

Responses

✅ 201 - Success

⚠️ 400 - undefined

⚠️ 401 - undefined

⚠️ 404 - undefined

❌ 500 - Internal Server Error

Tags

Artist

Authorizations

Authorization
string
header
required

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

Body

application/json
artistName
string
required

The name of the artist

signDate
string<date>
required

The date the artist was signed

users
string[]
required

An array of user IDs associated with the artist

split
object[]
required

An array of objects containing user IDs and their respective shares

externalId
string

The external ID of the artist

label
string

The label associated with the artist

Copyright information

publisher
string

Publisher information

contributors
object[]

Contributors to the artist

Links to the artist's website and social media profiles

Response

Success

message
string
artist
object
I