Skip to main content
PATCH
/
api
/
agent
/
{agent_id}
/
experience
curl -X PATCH https://api.vaanivoice.ai/api/agent/7ec4155e-0e62-440a-b983-5974f7697854/experience \
  -H "X-API-Key: vaani_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "conversational_experience": {
      "eagerness_to_speak": "fast",
      "bg_noise": { "enabled": true, "volume": 0.2, "sound": "office" }
    },
    "settings": {
      "call_settings": {
        "max_call_duration": 30,
        "max_duration_enabled": true,
        "enable_voicemail_detection": true,
        "action": "leave_message",
        "end_call_message": "Sorry we missed you, please call back during business hours."
      }
    }
  }'

{
  "success": true,
  "message": "Experience section updated successfully"
}

​
Update Agent Experience

Partially update the experience section of an agent. Only the fields you include are merged into the existing config; omitted fields remain unchanged. The experience section controls the conversational feel (background noise, filler words, speaking pace) and call-level settings (idle timeouts, max duration, voicemail detection).

​
Path Parameters

​
agent_id
string
required
UUID of the agent to update.

​
Body Parameters

​
conversational_experience
object
Settings that shape how the agent sounds and behaves during a conversation.
​
settings
object
Call-level operational settings.

​
Request Example

curl -X PATCH https://api.vaanivoice.ai/api/agent/7ec4155e-0e62-440a-b983-5974f7697854/experience \
  -H "X-API-Key: vaani_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "conversational_experience": {
      "eagerness_to_speak": "fast",
      "bg_noise": { "enabled": true, "volume": 0.2, "sound": "office" }
    },
    "settings": {
      "call_settings": {
        "max_call_duration": 30,
        "max_duration_enabled": true,
        "enable_voicemail_detection": true,
        "action": "leave_message",
        "end_call_message": "Sorry we missed you, please call back during business hours."
      }
    }
  }'

​
Response

{
  "success": true,
  "message": "Experience section updated successfully"
}