Skip to main content
DELETE
/
api
/
catalogs
cURL
curl --request DELETE \
  --url https://api.recoupable.com/api/catalogs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "catalogs": [
    {
      "catalog_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}
'
{
  "status": "success",
  "catalogs": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "error": "<string>"
}
When unlinking a catalog from an account, if no other accounts remain linked to the catalog, the catalog is automatically deleted (cascading to catalog_songs). Otherwise, only the account-catalog relationship is removed.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Array of catalog-account pairs to remove

catalogs
object[]
required

Array of catalog-account pairs to remove

Response

Catalogs unlinked successfully

Response containing catalogs data

status
enum<string>

Status of the request

Available options:
success,
error
catalogs
object[]

Array of catalog objects

error
string

Error message (only present if status is 'error')