Skip to main content
DELETE
/
api
/
artists
/
{id}
cURL
curl --request DELETE \
  --url https://api.recoupable.dev/api/artists/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "success": true,
  "artistId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Path Parameters

id
string<uuid>
required

Artist account ID to delete.

Body

application/json

Optional account context override.

account_id
string<uuid>

UUID of the account whose artist should be deleted. Only applicable when the authenticated account has access to multiple accounts via organization membership or Recoup admin access. If not provided, the deletion runs in the API key's own account context.

Response

Artist deleted successfully

success
boolean
required

Whether the artist delete completed successfully

artistId
string<uuid>
required

UUID of the artist account that was deleted or unlinked