Delete Catalog
Delete a catalog. Removes the catalog, its song membership (catalog_songs), its ownership links (account_catalogs) and its stored valuation history (catalog_valuations).
The measurement that produced the catalog is not deleted. A playcount snapshot is a metered capture that spent credits and cannot be reproduced for a past date, while a catalog is a label over songs that can be rebuilt from it in one call — so deleting a catalog only clears the snapshot’s reference to it. The snapshot then reads as unclaimed, and Create catalog can re-materialize it under a correct name. The released snapshot IDs are returned so that recovery does not require hunting for them.
Use this for genuine duplicates. To fix a catalog’s name, use Rename catalog instead — it keeps the catalog’s measurements and valuation history intact.
Authorizations
Your Recoup API key. Learn more.
Path Parameters
ID of the catalog to delete.
Response
Catalog deleted
Response returned after deleting a catalog
Status of the request
success ID of the deleted catalog
IDs of the playcount snapshots that pointed at this catalog. Those snapshots still exist - only their catalog reference was cleared - so each can be re-materialized into a new, correctly named catalog with Create catalog. Empty when the catalog was not created from a measurement run.
