Skip to main content
PUT
/
artist
/
{id}
/
merge
Merge Artists
curl --request PUT \
  --url https://api.royalti.io/artist/{id}/merge \
  --header 'Authorization: Bearer <token>'
{
  "message": "Artists merged successfully",
  "assetsUpdatedCount": 5,
  "productsUpdatedCount": 3,
  "artistsDeletedCount": 2,
  "totalChanges": 10
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

artist//merge Description:
The /artist/{id}/merge endpoint merges one or more artists into a primary artist. All assets and products from the secondary artists will be associated with the primary artist, and the secondary artists will be deleted after the merge. Method:
PUT Path Parameter:
ParameterTypeDescription
idstringThe ID of the primary artist to merge into.
Query Parameters:
ParameterRequiredTypeDescription
idsYesstringComma-separated list of artist IDs to merge into the primary artist

​
Code Examples

const response = await fetch('https://api.royalti.io/artist/example-id/merge', {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
});

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

Primary Artist ID to merge into

Query Parameters

​
ids
string
required

Comma-separated list of secondary artist IDs to merge

Response

Success

​
message
string
​
assetsUpdatedCount
integer

Number of assets reassigned to the primary artist

​
productsUpdatedCount
integer

Number of products reassigned to the primary artist

​
artistsDeletedCount
integer

Number of secondary artists deleted after merge

​
totalChanges
integer

Total number of changes made (sum of all updates and deletions)