Skip to main content
PUT
/
api
/
v2
/
voice-clones
/
{voiceId}
Update Voice Clone
curl --request PUT \
  --url https://api.buena.ai/api/v2/voice-clones/{voiceId} \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "settings": {
    "stability": 123,
    "clarity": 123,
    "use_speaker_boost": true
  }
}'
{
  "success": true,
  "data": {
    "id": "voice_abc123",
    "name": "Professional Sales Voice",
    "description": "Optimized for B2B outreach campaigns",
    "status": "ready",
    "settings": {
      "stability": 0.7,
      "clarity": 0.9,
      "use_speaker_boost": true
    },
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T15:30:00Z"
  }
}
Update an existing voice clone’s settings, name, or description. This allows you to fine-tune voice generation parameters and organize your voice clones.
Requires the voice:update permission.

​
Request

​
voiceId
string
required
The unique identifier of the voice clone to update
​
x-api-key
string
required
Your API key with voice:update permission
​
Content-Type
string
required
Must be application/json

​
Body Parameters

​
name
string
Updated name for the voice clone
​
description
string
Updated description of the voice clone
​
settings
object
Voice generation settings to update

​
Examples

​
Update Voice Settings

curl -X PUT "https://api.buena.ai/api/v2/voice-clones/voice_abc123" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Professional Sales Voice",
    "description": "Optimized for B2B outreach campaigns",
    "settings": {
      "stability": 0.7,
      "clarity": 0.9,
      "use_speaker_boost": true
    }
  }'

​
Response

​
success
boolean
Always true for successful requests
​
data
object
The updated voice clone information
{
  "success": true,
  "data": {
    "id": "voice_abc123",
    "name": "Professional Sales Voice",
    "description": "Optimized for B2B outreach campaigns",
    "status": "ready",
    "settings": {
      "stability": 0.7,
      "clarity": 0.9,
      "use_speaker_boost": true
    },
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T15:30:00Z"
  }
}

​
Next Steps

Test Changes

Generate preview with new settings

List Voice Clones

View all your voice clones

LinkedIn Voice Messages

Use updated voice in campaigns

Voice Clone Guide

Learn optimization best practices
⌘I