Skip to main content
DELETE
/
split
/
bulk
/
catalog-splits
Bulk delete catalog splits
curl --request DELETE \
  --url https://api.royalti.io/split/bulk/catalog-splits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "d1c5b49e-95fa-4aed-930e-cf314c16a53d",
    "e2d6c5af-96gb-5bed-a41f-df425d27b64e",
    "f3e7d6bg-a7hc-6cfe-b52g-eg536e38c75f"
  ],
  "type": "asset"
}
'
{
  "message": "Asset splits deletion completed.",
  "totalProcessed": 3,
  "totalSplitsDeleted": 7,
  "failedDeletions": []
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

Bulk Delete Catalog Splits The Bulk Delete Catalog Splits endpoint (/split/bulk/catalog-splits) allows users to delete all splits associated with specific assets or products in bulk. Method:
DELETE Request Payload: The request payload should be a JSON object with an array of asset or product IDs and the type specifying whether they are assets or products.
ParameterTypeRequiredDescription
idsstring[]YesAn array of asset or product IDs (UUIDs)
typestringYesEither “asset” or “product” to specify the type of entities
This request deletes all splits associated with the specified assets or products. For assets, only asset-level splits are deleted (where ProductId is null). For products, all splits associated with the product are deleted.

​
Code Examples

const response = await fetch('https://api.royalti.io/split/bulk/catalog-splits', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

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
​
ids
string<uuid>[]
required

An array of asset or product IDs (UUIDs)

​
type
enum<string>
required

Type of entities - either "asset" or "product"

Available options:
asset,
product

Response

Catalog splits deleted successfully

​
message
string
​
totalProcessed
integer
​
totalSplitsDeleted
integer
​
failedDeletions
object[]