Skip to main content
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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.buena.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Check for active usage:
  • Review any scheduled LinkedIn campaigns
  • Check if voice clone is referenced in automation workflows
  • Ensure no pending voice message generations
  • Consider updating campaigns to use alternative voice clones
Voice clone recovery:
  • Voice clones cannot be recovered after deletion
  • Consider exporting voice settings before deletion
  • Keep original training audio files for recreation if needed
  • Document voice clone configurations for future reference

​
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