Skip to main content
PUT
/
artist
/
{id}
Update Artist
curl --request PUT \
  --url https://api.royalti.io/artist/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "artistName": "<string>",
  "signDate": "2023-12-25",
  "label": "<string>",
  "publisher": "<string>",
  "copyright": "<string>",
  "externalId": "<string>",
  "links": {},
  "contributors": {},
  "split": [
    {
      "user": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "share": 123
    }
  ],
  "users": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'
{
  "message": "Artist updated successfully"
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

artist/ Description:
The /artist/{id} endpoint allows updating the details of a specific artist identified by their unique ID. Method:
PUT Path Parameter:
ParameterTypeDescription
idstringThe unique identifier of the artist.
Request Payload:
ParameterTypeDescription
artistNamestringThe updated name of the artist.
signDatedateThe updated sign date.
labelstringThe updated label.
publisherstringThe updated publisher.
copyrightstringThe updated copyright information.
externalIdstringThe updated external ID.
linksobjectUpdated links (JSON string when using multipart/form-data).
contributorsobjectUpdated contributors.
splitarray/objectUpdated split information (supports both array and object format).
filefileArtist profile image (when using multipart/form-data).
usersarrayArray of user IDs to associate with artist.
Note: This endpoint supports both application/json and multipart/form-data. Use multipart/form-data when uploading an artist image file.

​
Code Examples

const response = await fetch('https://api.royalti.io/artist/example-id', {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "artistName": "sample-artistName",
    "signDate": "2024-01-21",
    "label": "sample-label",
    "publisher": "sample-publisher",
    "copyright": "sample-copyright",
    "externalId": "sample-externalId",
    "links": {},
    "contributors": {},
    "users": [
      {}
    ]
  })
});

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

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Artist ID

Body

​
artistName
string
​
signDate
string<date>
​
label
string
​
publisher
string
​
copyright
string
​
externalId
string
​
links
object
​
contributors
object
​
split
object
​
users
string<uuid>[]

Response

Success

​
message
string
​
artist
object