DELETE
/
api
/
v2
/
voice-clones
/
{voiceId}
Delete Voice Clone
curl --request DELETE \
  --url https://api.buena.ai/api/v2/voice-clones/{voiceId} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "message": "Voice clone 'Professional Voice' has been successfully deleted",
  "deleted_id": "voice_abc123"
}

Permanently delete a voice clone from your account. This action cannot be undone and will immediately make the voice clone unavailable for use in campaigns.

This action is irreversible. Make sure you’re not using this voice clone in any active campaigns before deleting it.

Requires the voice:delete permission.

​
Request

​
voiceId
string
required

The unique identifier of the voice clone to delete

​
x-api-key
string
required

Your API key with voice:delete permission

​
Examples

curl -X DELETE "https://api.buena.ai/api/v2/voice-clones/voice_abc123" \
  -H "x-api-key: YOUR_API_KEY"

​
Response

​
success
boolean

Always true for successful requests

​
message
string

Confirmation message about the deletion

​
deleted_id
string

The ID of the voice clone that was deleted

{
  "success": true,
  "message": "Voice clone 'Professional Voice' has been successfully deleted",
  "deleted_id": "voice_abc123"
}

​
Error Responses

​
Voice Clone Not Found (404)

{
  "error": true,
  "code": "VOICE_CLONE_NOT_FOUND",
  "message": "Voice clone not found",
  "version": "2.0",
  "timestamp": "2024-01-20T15:30:00Z",
  "details": {
    "voice_id": "voice_abc123"
  }
}

​
Voice Clone In Use (409)

{
  "error": true,
  "code": "VOICE_CLONE_IN_USE",
  "message": "Cannot delete voice clone as it is currently being used in active campaigns",
  "version": "2.0",
  "timestamp": "2024-01-20T15:30:00Z",
  "details": {
    "active_campaigns": 3,
    "last_used": "2024-01-20T14:30:00Z"
  }
}

​
Best Practices

​
Alternative Actions

Instead of deleting, consider:

  • Updating settings to improve voice quality
  • Renaming to better organize your voice clones
  • Creating a new voice clone with improved training data
  • Temporarily disabling in campaigns while keeping the clone

​
Next Steps

Create New Voice Clone

Create a replacement voice clone

List Voice Clones

View remaining voice clones

Voice Clone Guide

Learn voice clone best practices

LinkedIn Campaigns

Update campaigns with new voice clones