- API reference
- Recommendations
Get a new upload URL
POST/public/recommendations/catalogues/{catalogueId}/upload-url
CoreAuthBasic
Answers a new upload URL for the catalogue, to replace its file. Commit after the upload: the new file replaces the catalogue, and ISRCs that are not in the new file leave it. Needs Client Secret authentication.
Path parameters
catalogueId
stringrequired
The catalogue id from POST /public/recommendations/catalogues.
Response
200application/json · RecommendationCatalogueUploadok
id
string
required
uploadUrl
uri
requiredPUT the file here. Valid for one hour.
expiresAt
date-time
required
{
"id": "42",
"uploadUrl": "https://example.com",
"expiresAt": "2026-10-16T09:41:07.000Z"
}
Errors
401
No valid credential.
403
The request does not use Client Secret authentication.
404
catalogue_not_found: the catalogue does not exist or is not yours.
409
catalogue_busy: an import of the catalogue runs.
429
Your account sent more calls this minute than its rate limit allows.