- API reference
- Recommendations
Add or remove catalogue ISRCs
Adds and removes ISRCs of a ready catalogue, at most 10,000 in one call. Use it for daily changes; only the named ISRCs change. An ISRC in both lists is removed. The answer is the catalogue with the new counts. Needs Client Secret authentication.
Path parameters
The catalogue id from POST /public/recommendations/catalogues.
Request body
application/json · required
Response
ready catalogue stays ready while a new file imports.withVector / isrcs.catalogue_limit, upload_missing, file_too_large or import_failed. After a failed new file of a ready catalogue, the status stays ready with the old data.{
"id": "42",
"name": "Main catalogue",
"status": "awaitingUpload",
"importing": true,
"isrcs": 120000,
"invalid": 12,
"matched": 101000,
"withVector": 88000,
"coverage": 0.7333,
"error": "string",
"createdAt": "2026-10-16T09:41:07.000Z",
"updatedAt": "2026-10-16T09:41:07.000Z"
}
Errors
A value is not an ISRC, or the lists hold more than 10,000 ISRCs together.
No valid credential.
The request does not use Client Secret authentication.
catalogue_not_found: the catalogue does not exist or is not yours.
catalogue_not_ready or catalogue_busy: the catalogue is not ready, or an import runs. catalogue_limit: the change passes the limit of your account (all catalogues together).
Your account sent more calls this minute than its rate limit allows.