Skip to the content
  1. API reference
  2. 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
Example answer
{
  "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.