PUT
/
api
/
v2
/
voice-clones
/
{voiceId}
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