Skip to main content
PUT
/
product
/
bulk
/
defaultsplit
Set Default Split for Bulk Products
curl --request PUT \
  --url https://api.royalti.io/product/bulk/defaultsplit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "products": [
    "product-id-1",
    "product-id-2"
  ]
}
'
{
  "message": "Bulk product default splits processed.",
  "processed": 5,
  "errors": [
    "product-id-3 - Artist default split not set!"
  ]
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

/product/bulk/defaultsplit Description:
The /product/bulk/defaultsplit endpoint allows setting default splits for multiple products simultaneously. Method:
PATCH Request Payload:
ParameterTypeDescription
productIdsarrayAn array of product IDs.
defaultSplitarrayDefault split configuration.

​
Code Examples

const response = await fetch('https://api.royalti.io/product/bulk/defaultsplit', {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "products": [
      {}
    ]
  })
});

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

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
products
string[]
required

Array of product IDs to update with default splits

Response

Successfully processed bulk product default splits

​
message
string
Example:

"Bulk product default splits processed."

​
processed
integer

Number of products successfully processed

​
errors
string[]

Array of error messages for any products that failed processing