Skip to main content
PUT
/
artist
/
{id}
/
merge
Merge Artists
curl --request PUT \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/artist/{id}/merge \
  --header 'Authorization: Bearer <token>'
{
  "message": "Artists merged successfully",
  "assetsUpdatedCount": 5,
  "productsUpdatedCount": 3,
  "artistsDeletedCount": 2,
  "totalChanges": 10
}
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

Authentication

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

Path Parameters

ParameterTypeInRequiredDescription
idstringpathāœ…Primary Artist ID to merge into

Query Parameters

ParameterTypeInRequiredDescription
idsstringqueryāœ…Comma-separated list of secondary artist IDs to merge

Responses

āœ… 200 - Success

āš ļø 400 - Bad Request - No secondary artist IDs provided

āš ļø 401 - undefined

āš ļø 404 - Not Found - Primary artist or one or more secondary artists not found

āŒ 500 - undefined

Tags

Artist

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)

⌘I