Create Catalog
Create a catalog, owned by the calling account or - with organization_id - by one of the caller’s organizations, in which case every member of that organization sees it via Get Catalogs. When materializing from a valuation snapshot, the endpoint also attaches the snapshot’s canonical artist to the caller’s roster: the measured songs’ existing song-artist links are resolved to the dominant artist account, which is added to the caller’s roster if not already present. The attach also runs on idempotent re-claims of an already-materialized snapshot. The roster attach always targets the calling account, even when the catalog is owned by an organization.
Authorizations
Your Recoup API key. Learn more.
Body
Catalog to create. Provide name, snapshot, or both - at least one is required.
Request body for creating a catalog. At least one of name or snapshot must be supplied. The catalog is owned by the authenticated account unless organization_id names an organization to own it instead.
Optional. Display name for the catalog. If omitted when snapshot is supplied, a name is derived from the source run.
Optional. ID of a completed playcount snapshot (valuation run) owned by the authenticated account. Its measured ISRCs are added to the new catalog as catalog songs. Create one with Create measurement job.
Optional. ID of an organization to own the catalog instead of the calling account. Every member of that organization then sees the catalog in their own Get Catalogs response, without passing the organization's id. The caller must be a member of the organization; otherwise the request is rejected with 403. Omit to own the catalog personally, which is the default.
Response
Catalog created, or the existing catalog returned when re-materializing the same snapshot (idempotent)
Response returned after creating, or idempotently re-fetching, a catalog
Status of the request
success, error A catalog with its metadata
Number of catalog songs materialized from the source. 0 when no snapshot was supplied, or when the run was already materialized (idempotent re-claim).
Error message (only present if status is 'error')
