curl --request PATCH \
--url https://api.verbose.cx/v1/agents/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"name": "Debt-relief qualifier",
"system_prompt": "You are a friendly assistant qualifying debt-relief leads…",
"channel": "sms",
"status": "active",
"goal": "Book a call with a specialist",
"greeting": "Hi {first_name}! Quick question —",
"model": "<string>",
"max_turns": 20,
"handoff_keywords": [
"agent",
"representative"
],
"voice_id": "11labs-Jenny",
"language": "en-US",
"inbox": {
"mode": "handoff",
"intent_threshold": "hot",
"suppress_keywords": [
"stop",
"wrong number"
]
},
"sms": {
"tone": "friendly",
"creativity": "medium",
"guardrails": [
"Never quote a price",
"Don't give legal advice"
],
"max_length": 320,
"knowledge": "<string>",
"handoff_on_low_confidence": true,
"handoff_after_turns": 6,
"handoff_on_negative": true,
"handoff_message": "<string>",
"reply_delay_min_sec": 2,
"reply_delay_max_sec": 8,
"max_replies_per_day": 10,
"capture_fields": [
"email",
"zip"
],
"link_domain_id": "<string>",
"conversion_keywords": [
"yes",
"interested"
],
"conversion_on_agent_goal": true,
"followup_enabled": true,
"followup_count": 2,
"followup_delay_hours": 24,
"quiet_start_hour": 21,
"quiet_end_hour": 8,
"quiet_tz": "America/New_York"
},
"voice": {
"voice_id": "11labs-Jenny",
"language": "en-US",
"end_call": true,
"speed": 1,
"temperature": 1,
"volume": 1,
"responsiveness": 1,
"interruption_sensitivity": 1,
"enable_backchannel": false,
"backchannel_frequency": 0.8,
"reminder_trigger_ms": 10000,
"end_call_after_silence_ms": 600000,
"max_call_duration_ms": 3600000,
"ambient_sound": "call-center",
"boosted_keywords": [
"Astrasend",
"tadalafil"
],
"model_temperature": 0.7,
"voicemail_message": "<string>"
}
}
EOFimport requests
url = "https://api.verbose.cx/v1/agents/{id}"
payload = {
"name": "Debt-relief qualifier",
"system_prompt": "You are a friendly assistant qualifying debt-relief leads…",
"channel": "sms",
"status": "active",
"goal": "Book a call with a specialist",
"greeting": "Hi {first_name}! Quick question —",
"model": "<string>",
"max_turns": 20,
"handoff_keywords": ["agent", "representative"],
"voice_id": "11labs-Jenny",
"language": "en-US",
"inbox": {
"mode": "handoff",
"intent_threshold": "hot",
"suppress_keywords": ["stop", "wrong number"]
},
"sms": {
"tone": "friendly",
"creativity": "medium",
"guardrails": ["Never quote a price", "Don't give legal advice"],
"max_length": 320,
"knowledge": "<string>",
"handoff_on_low_confidence": True,
"handoff_after_turns": 6,
"handoff_on_negative": True,
"handoff_message": "<string>",
"reply_delay_min_sec": 2,
"reply_delay_max_sec": 8,
"max_replies_per_day": 10,
"capture_fields": ["email", "zip"],
"link_domain_id": "<string>",
"conversion_keywords": ["yes", "interested"],
"conversion_on_agent_goal": True,
"followup_enabled": True,
"followup_count": 2,
"followup_delay_hours": 24,
"quiet_start_hour": 21,
"quiet_end_hour": 8,
"quiet_tz": "America/New_York"
},
"voice": {
"voice_id": "11labs-Jenny",
"language": "en-US",
"end_call": True,
"speed": 1,
"temperature": 1,
"volume": 1,
"responsiveness": 1,
"interruption_sensitivity": 1,
"enable_backchannel": False,
"backchannel_frequency": 0.8,
"reminder_trigger_ms": 10000,
"end_call_after_silence_ms": 600000,
"max_call_duration_ms": 3600000,
"ambient_sound": "call-center",
"boosted_keywords": ["Astrasend", "tadalafil"],
"model_temperature": 0.7,
"voicemail_message": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Debt-relief qualifier',
system_prompt: 'You are a friendly assistant qualifying debt-relief leads…',
channel: 'sms',
status: 'active',
goal: 'Book a call with a specialist',
greeting: 'Hi {first_name}! Quick question —',
model: '<string>',
max_turns: 20,
handoff_keywords: ['agent', 'representative'],
voice_id: '11labs-Jenny',
language: 'en-US',
inbox: {
mode: 'handoff',
intent_threshold: 'hot',
suppress_keywords: ['stop', 'wrong number']
},
sms: {
tone: 'friendly',
creativity: 'medium',
guardrails: ['Never quote a price', 'Don\'t give legal advice'],
max_length: 320,
knowledge: '<string>',
handoff_on_low_confidence: true,
handoff_after_turns: 6,
handoff_on_negative: true,
handoff_message: '<string>',
reply_delay_min_sec: 2,
reply_delay_max_sec: 8,
max_replies_per_day: 10,
capture_fields: ['email', 'zip'],
link_domain_id: '<string>',
conversion_keywords: ['yes', 'interested'],
conversion_on_agent_goal: true,
followup_enabled: true,
followup_count: 2,
followup_delay_hours: 24,
quiet_start_hour: 21,
quiet_end_hour: 8,
quiet_tz: 'America/New_York'
},
voice: {
voice_id: '11labs-Jenny',
language: 'en-US',
end_call: true,
speed: 1,
temperature: 1,
volume: 1,
responsiveness: 1,
interruption_sensitivity: 1,
enable_backchannel: false,
backchannel_frequency: 0.8,
reminder_trigger_ms: 10000,
end_call_after_silence_ms: 600000,
max_call_duration_ms: 3600000,
ambient_sound: 'call-center',
boosted_keywords: ['Astrasend', 'tadalafil'],
model_temperature: 0.7,
voicemail_message: '<string>'
}
})
};
fetch('https://api.verbose.cx/v1/agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.verbose.cx/v1/agents/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Debt-relief qualifier',
'system_prompt' => 'You are a friendly assistant qualifying debt-relief leads…',
'channel' => 'sms',
'status' => 'active',
'goal' => 'Book a call with a specialist',
'greeting' => 'Hi {first_name}! Quick question —',
'model' => '<string>',
'max_turns' => 20,
'handoff_keywords' => [
'agent',
'representative'
],
'voice_id' => '11labs-Jenny',
'language' => 'en-US',
'inbox' => [
'mode' => 'handoff',
'intent_threshold' => 'hot',
'suppress_keywords' => [
'stop',
'wrong number'
]
],
'sms' => [
'tone' => 'friendly',
'creativity' => 'medium',
'guardrails' => [
'Never quote a price',
'Don\'t give legal advice'
],
'max_length' => 320,
'knowledge' => '<string>',
'handoff_on_low_confidence' => true,
'handoff_after_turns' => 6,
'handoff_on_negative' => true,
'handoff_message' => '<string>',
'reply_delay_min_sec' => 2,
'reply_delay_max_sec' => 8,
'max_replies_per_day' => 10,
'capture_fields' => [
'email',
'zip'
],
'link_domain_id' => '<string>',
'conversion_keywords' => [
'yes',
'interested'
],
'conversion_on_agent_goal' => true,
'followup_enabled' => true,
'followup_count' => 2,
'followup_delay_hours' => 24,
'quiet_start_hour' => 21,
'quiet_end_hour' => 8,
'quiet_tz' => 'America/New_York'
],
'voice' => [
'voice_id' => '11labs-Jenny',
'language' => 'en-US',
'end_call' => true,
'speed' => 1,
'temperature' => 1,
'volume' => 1,
'responsiveness' => 1,
'interruption_sensitivity' => 1,
'enable_backchannel' => false,
'backchannel_frequency' => 0.8,
'reminder_trigger_ms' => 10000,
'end_call_after_silence_ms' => 600000,
'max_call_duration_ms' => 3600000,
'ambient_sound' => 'call-center',
'boosted_keywords' => [
'Astrasend',
'tadalafil'
],
'model_temperature' => 0.7,
'voicemail_message' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.verbose.cx/v1/agents/{id}"
payload := strings.NewReader("{\n \"name\": \"Debt-relief qualifier\",\n \"system_prompt\": \"You are a friendly assistant qualifying debt-relief leads…\",\n \"channel\": \"sms\",\n \"status\": \"active\",\n \"goal\": \"Book a call with a specialist\",\n \"greeting\": \"Hi {first_name}! Quick question —\",\n \"model\": \"<string>\",\n \"max_turns\": 20,\n \"handoff_keywords\": [\n \"agent\",\n \"representative\"\n ],\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"inbox\": {\n \"mode\": \"handoff\",\n \"intent_threshold\": \"hot\",\n \"suppress_keywords\": [\n \"stop\",\n \"wrong number\"\n ]\n },\n \"sms\": {\n \"tone\": \"friendly\",\n \"creativity\": \"medium\",\n \"guardrails\": [\n \"Never quote a price\",\n \"Don't give legal advice\"\n ],\n \"max_length\": 320,\n \"knowledge\": \"<string>\",\n \"handoff_on_low_confidence\": true,\n \"handoff_after_turns\": 6,\n \"handoff_on_negative\": true,\n \"handoff_message\": \"<string>\",\n \"reply_delay_min_sec\": 2,\n \"reply_delay_max_sec\": 8,\n \"max_replies_per_day\": 10,\n \"capture_fields\": [\n \"email\",\n \"zip\"\n ],\n \"link_domain_id\": \"<string>\",\n \"conversion_keywords\": [\n \"yes\",\n \"interested\"\n ],\n \"conversion_on_agent_goal\": true,\n \"followup_enabled\": true,\n \"followup_count\": 2,\n \"followup_delay_hours\": 24,\n \"quiet_start_hour\": 21,\n \"quiet_end_hour\": 8,\n \"quiet_tz\": \"America/New_York\"\n },\n \"voice\": {\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"end_call\": true,\n \"speed\": 1,\n \"temperature\": 1,\n \"volume\": 1,\n \"responsiveness\": 1,\n \"interruption_sensitivity\": 1,\n \"enable_backchannel\": false,\n \"backchannel_frequency\": 0.8,\n \"reminder_trigger_ms\": 10000,\n \"end_call_after_silence_ms\": 600000,\n \"max_call_duration_ms\": 3600000,\n \"ambient_sound\": \"call-center\",\n \"boosted_keywords\": [\n \"Astrasend\",\n \"tadalafil\"\n ],\n \"model_temperature\": 0.7,\n \"voicemail_message\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.verbose.cx/v1/agents/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Debt-relief qualifier\",\n \"system_prompt\": \"You are a friendly assistant qualifying debt-relief leads…\",\n \"channel\": \"sms\",\n \"status\": \"active\",\n \"goal\": \"Book a call with a specialist\",\n \"greeting\": \"Hi {first_name}! Quick question —\",\n \"model\": \"<string>\",\n \"max_turns\": 20,\n \"handoff_keywords\": [\n \"agent\",\n \"representative\"\n ],\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"inbox\": {\n \"mode\": \"handoff\",\n \"intent_threshold\": \"hot\",\n \"suppress_keywords\": [\n \"stop\",\n \"wrong number\"\n ]\n },\n \"sms\": {\n \"tone\": \"friendly\",\n \"creativity\": \"medium\",\n \"guardrails\": [\n \"Never quote a price\",\n \"Don't give legal advice\"\n ],\n \"max_length\": 320,\n \"knowledge\": \"<string>\",\n \"handoff_on_low_confidence\": true,\n \"handoff_after_turns\": 6,\n \"handoff_on_negative\": true,\n \"handoff_message\": \"<string>\",\n \"reply_delay_min_sec\": 2,\n \"reply_delay_max_sec\": 8,\n \"max_replies_per_day\": 10,\n \"capture_fields\": [\n \"email\",\n \"zip\"\n ],\n \"link_domain_id\": \"<string>\",\n \"conversion_keywords\": [\n \"yes\",\n \"interested\"\n ],\n \"conversion_on_agent_goal\": true,\n \"followup_enabled\": true,\n \"followup_count\": 2,\n \"followup_delay_hours\": 24,\n \"quiet_start_hour\": 21,\n \"quiet_end_hour\": 8,\n \"quiet_tz\": \"America/New_York\"\n },\n \"voice\": {\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"end_call\": true,\n \"speed\": 1,\n \"temperature\": 1,\n \"volume\": 1,\n \"responsiveness\": 1,\n \"interruption_sensitivity\": 1,\n \"enable_backchannel\": false,\n \"backchannel_frequency\": 0.8,\n \"reminder_trigger_ms\": 10000,\n \"end_call_after_silence_ms\": 600000,\n \"max_call_duration_ms\": 3600000,\n \"ambient_sound\": \"call-center\",\n \"boosted_keywords\": [\n \"Astrasend\",\n \"tadalafil\"\n ],\n \"model_temperature\": 0.7,\n \"voicemail_message\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.verbose.cx/v1/agents/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Debt-relief qualifier\",\n \"system_prompt\": \"You are a friendly assistant qualifying debt-relief leads…\",\n \"channel\": \"sms\",\n \"status\": \"active\",\n \"goal\": \"Book a call with a specialist\",\n \"greeting\": \"Hi {first_name}! Quick question —\",\n \"model\": \"<string>\",\n \"max_turns\": 20,\n \"handoff_keywords\": [\n \"agent\",\n \"representative\"\n ],\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"inbox\": {\n \"mode\": \"handoff\",\n \"intent_threshold\": \"hot\",\n \"suppress_keywords\": [\n \"stop\",\n \"wrong number\"\n ]\n },\n \"sms\": {\n \"tone\": \"friendly\",\n \"creativity\": \"medium\",\n \"guardrails\": [\n \"Never quote a price\",\n \"Don't give legal advice\"\n ],\n \"max_length\": 320,\n \"knowledge\": \"<string>\",\n \"handoff_on_low_confidence\": true,\n \"handoff_after_turns\": 6,\n \"handoff_on_negative\": true,\n \"handoff_message\": \"<string>\",\n \"reply_delay_min_sec\": 2,\n \"reply_delay_max_sec\": 8,\n \"max_replies_per_day\": 10,\n \"capture_fields\": [\n \"email\",\n \"zip\"\n ],\n \"link_domain_id\": \"<string>\",\n \"conversion_keywords\": [\n \"yes\",\n \"interested\"\n ],\n \"conversion_on_agent_goal\": true,\n \"followup_enabled\": true,\n \"followup_count\": 2,\n \"followup_delay_hours\": 24,\n \"quiet_start_hour\": 21,\n \"quiet_end_hour\": 8,\n \"quiet_tz\": \"America/New_York\"\n },\n \"voice\": {\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"end_call\": true,\n \"speed\": 1,\n \"temperature\": 1,\n \"volume\": 1,\n \"responsiveness\": 1,\n \"interruption_sensitivity\": 1,\n \"enable_backchannel\": false,\n \"backchannel_frequency\": 0.8,\n \"reminder_trigger_ms\": 10000,\n \"end_call_after_silence_ms\": 600000,\n \"max_call_duration_ms\": 3600000,\n \"ambient_sound\": \"call-center\",\n \"boosted_keywords\": [\n \"Astrasend\",\n \"tadalafil\"\n ],\n \"model_temperature\": 0.7,\n \"voicemail_message\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"ok": true,
"agent": {
"id": "a9c1f0d2-...",
"name": "Debt-relief qualifier",
"channel": "sms",
"status": "active",
"system_prompt": "<string>",
"goal": "<string>",
"greeting": "<string>",
"max_turns": 20,
"handoff_keywords": [
"<string>"
],
"voice_id": "<string>",
"voice": {
"voice_id": "11labs-Jenny",
"language": "en-US",
"end_call": true,
"speed": 1,
"temperature": 1,
"volume": 1,
"responsiveness": 1,
"interruption_sensitivity": 1,
"enable_backchannel": false,
"backchannel_frequency": 0.8,
"reminder_trigger_ms": 10000,
"end_call_after_silence_ms": 600000,
"max_call_duration_ms": 3600000,
"ambient_sound": "call-center",
"boosted_keywords": [
"Astrasend",
"tadalafil"
],
"model_temperature": 0.7,
"voicemail_message": "<string>"
},
"sms": {
"tone": "friendly",
"creativity": "medium",
"guardrails": [
"Never quote a price",
"Don't give legal advice"
],
"max_length": 320,
"knowledge": "<string>",
"handoff_on_low_confidence": true,
"handoff_after_turns": 6,
"handoff_on_negative": true,
"handoff_message": "<string>",
"reply_delay_min_sec": 2,
"reply_delay_max_sec": 8,
"max_replies_per_day": 10,
"capture_fields": [
"email",
"zip"
],
"link_domain_id": "<string>",
"conversion_keywords": [
"yes",
"interested"
],
"conversion_on_agent_goal": true,
"followup_enabled": true,
"followup_count": 2,
"followup_delay_hours": 24,
"quiet_start_hour": 21,
"quiet_end_hour": 8,
"quiet_tz": "America/New_York"
},
"inbox": {
"mode": "handoff",
"intent_threshold": "hot",
"suppress_keywords": [
"stop",
"wrong number"
]
},
"created_at": "2026-09-01T14:12:00Z"
}
}{
"ok": false,
"error": "list_id is required"
}{
"ok": false,
"error": "Invalid or missing API key"
}{
"ok": false,
"error": "This API key cannot create and edit.",
"required_scope": "write"
}{
"ok": false,
"error": "Not found"
}Update an agent
Updates an agent’s prompt, goal, greeting, voice, or other settings. Changes apply to new conversations.
curl --request PATCH \
--url https://api.verbose.cx/v1/agents/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"name": "Debt-relief qualifier",
"system_prompt": "You are a friendly assistant qualifying debt-relief leads…",
"channel": "sms",
"status": "active",
"goal": "Book a call with a specialist",
"greeting": "Hi {first_name}! Quick question —",
"model": "<string>",
"max_turns": 20,
"handoff_keywords": [
"agent",
"representative"
],
"voice_id": "11labs-Jenny",
"language": "en-US",
"inbox": {
"mode": "handoff",
"intent_threshold": "hot",
"suppress_keywords": [
"stop",
"wrong number"
]
},
"sms": {
"tone": "friendly",
"creativity": "medium",
"guardrails": [
"Never quote a price",
"Don't give legal advice"
],
"max_length": 320,
"knowledge": "<string>",
"handoff_on_low_confidence": true,
"handoff_after_turns": 6,
"handoff_on_negative": true,
"handoff_message": "<string>",
"reply_delay_min_sec": 2,
"reply_delay_max_sec": 8,
"max_replies_per_day": 10,
"capture_fields": [
"email",
"zip"
],
"link_domain_id": "<string>",
"conversion_keywords": [
"yes",
"interested"
],
"conversion_on_agent_goal": true,
"followup_enabled": true,
"followup_count": 2,
"followup_delay_hours": 24,
"quiet_start_hour": 21,
"quiet_end_hour": 8,
"quiet_tz": "America/New_York"
},
"voice": {
"voice_id": "11labs-Jenny",
"language": "en-US",
"end_call": true,
"speed": 1,
"temperature": 1,
"volume": 1,
"responsiveness": 1,
"interruption_sensitivity": 1,
"enable_backchannel": false,
"backchannel_frequency": 0.8,
"reminder_trigger_ms": 10000,
"end_call_after_silence_ms": 600000,
"max_call_duration_ms": 3600000,
"ambient_sound": "call-center",
"boosted_keywords": [
"Astrasend",
"tadalafil"
],
"model_temperature": 0.7,
"voicemail_message": "<string>"
}
}
EOFimport requests
url = "https://api.verbose.cx/v1/agents/{id}"
payload = {
"name": "Debt-relief qualifier",
"system_prompt": "You are a friendly assistant qualifying debt-relief leads…",
"channel": "sms",
"status": "active",
"goal": "Book a call with a specialist",
"greeting": "Hi {first_name}! Quick question —",
"model": "<string>",
"max_turns": 20,
"handoff_keywords": ["agent", "representative"],
"voice_id": "11labs-Jenny",
"language": "en-US",
"inbox": {
"mode": "handoff",
"intent_threshold": "hot",
"suppress_keywords": ["stop", "wrong number"]
},
"sms": {
"tone": "friendly",
"creativity": "medium",
"guardrails": ["Never quote a price", "Don't give legal advice"],
"max_length": 320,
"knowledge": "<string>",
"handoff_on_low_confidence": True,
"handoff_after_turns": 6,
"handoff_on_negative": True,
"handoff_message": "<string>",
"reply_delay_min_sec": 2,
"reply_delay_max_sec": 8,
"max_replies_per_day": 10,
"capture_fields": ["email", "zip"],
"link_domain_id": "<string>",
"conversion_keywords": ["yes", "interested"],
"conversion_on_agent_goal": True,
"followup_enabled": True,
"followup_count": 2,
"followup_delay_hours": 24,
"quiet_start_hour": 21,
"quiet_end_hour": 8,
"quiet_tz": "America/New_York"
},
"voice": {
"voice_id": "11labs-Jenny",
"language": "en-US",
"end_call": True,
"speed": 1,
"temperature": 1,
"volume": 1,
"responsiveness": 1,
"interruption_sensitivity": 1,
"enable_backchannel": False,
"backchannel_frequency": 0.8,
"reminder_trigger_ms": 10000,
"end_call_after_silence_ms": 600000,
"max_call_duration_ms": 3600000,
"ambient_sound": "call-center",
"boosted_keywords": ["Astrasend", "tadalafil"],
"model_temperature": 0.7,
"voicemail_message": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Debt-relief qualifier',
system_prompt: 'You are a friendly assistant qualifying debt-relief leads…',
channel: 'sms',
status: 'active',
goal: 'Book a call with a specialist',
greeting: 'Hi {first_name}! Quick question —',
model: '<string>',
max_turns: 20,
handoff_keywords: ['agent', 'representative'],
voice_id: '11labs-Jenny',
language: 'en-US',
inbox: {
mode: 'handoff',
intent_threshold: 'hot',
suppress_keywords: ['stop', 'wrong number']
},
sms: {
tone: 'friendly',
creativity: 'medium',
guardrails: ['Never quote a price', 'Don\'t give legal advice'],
max_length: 320,
knowledge: '<string>',
handoff_on_low_confidence: true,
handoff_after_turns: 6,
handoff_on_negative: true,
handoff_message: '<string>',
reply_delay_min_sec: 2,
reply_delay_max_sec: 8,
max_replies_per_day: 10,
capture_fields: ['email', 'zip'],
link_domain_id: '<string>',
conversion_keywords: ['yes', 'interested'],
conversion_on_agent_goal: true,
followup_enabled: true,
followup_count: 2,
followup_delay_hours: 24,
quiet_start_hour: 21,
quiet_end_hour: 8,
quiet_tz: 'America/New_York'
},
voice: {
voice_id: '11labs-Jenny',
language: 'en-US',
end_call: true,
speed: 1,
temperature: 1,
volume: 1,
responsiveness: 1,
interruption_sensitivity: 1,
enable_backchannel: false,
backchannel_frequency: 0.8,
reminder_trigger_ms: 10000,
end_call_after_silence_ms: 600000,
max_call_duration_ms: 3600000,
ambient_sound: 'call-center',
boosted_keywords: ['Astrasend', 'tadalafil'],
model_temperature: 0.7,
voicemail_message: '<string>'
}
})
};
fetch('https://api.verbose.cx/v1/agents/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.verbose.cx/v1/agents/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Debt-relief qualifier',
'system_prompt' => 'You are a friendly assistant qualifying debt-relief leads…',
'channel' => 'sms',
'status' => 'active',
'goal' => 'Book a call with a specialist',
'greeting' => 'Hi {first_name}! Quick question —',
'model' => '<string>',
'max_turns' => 20,
'handoff_keywords' => [
'agent',
'representative'
],
'voice_id' => '11labs-Jenny',
'language' => 'en-US',
'inbox' => [
'mode' => 'handoff',
'intent_threshold' => 'hot',
'suppress_keywords' => [
'stop',
'wrong number'
]
],
'sms' => [
'tone' => 'friendly',
'creativity' => 'medium',
'guardrails' => [
'Never quote a price',
'Don\'t give legal advice'
],
'max_length' => 320,
'knowledge' => '<string>',
'handoff_on_low_confidence' => true,
'handoff_after_turns' => 6,
'handoff_on_negative' => true,
'handoff_message' => '<string>',
'reply_delay_min_sec' => 2,
'reply_delay_max_sec' => 8,
'max_replies_per_day' => 10,
'capture_fields' => [
'email',
'zip'
],
'link_domain_id' => '<string>',
'conversion_keywords' => [
'yes',
'interested'
],
'conversion_on_agent_goal' => true,
'followup_enabled' => true,
'followup_count' => 2,
'followup_delay_hours' => 24,
'quiet_start_hour' => 21,
'quiet_end_hour' => 8,
'quiet_tz' => 'America/New_York'
],
'voice' => [
'voice_id' => '11labs-Jenny',
'language' => 'en-US',
'end_call' => true,
'speed' => 1,
'temperature' => 1,
'volume' => 1,
'responsiveness' => 1,
'interruption_sensitivity' => 1,
'enable_backchannel' => false,
'backchannel_frequency' => 0.8,
'reminder_trigger_ms' => 10000,
'end_call_after_silence_ms' => 600000,
'max_call_duration_ms' => 3600000,
'ambient_sound' => 'call-center',
'boosted_keywords' => [
'Astrasend',
'tadalafil'
],
'model_temperature' => 0.7,
'voicemail_message' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.verbose.cx/v1/agents/{id}"
payload := strings.NewReader("{\n \"name\": \"Debt-relief qualifier\",\n \"system_prompt\": \"You are a friendly assistant qualifying debt-relief leads…\",\n \"channel\": \"sms\",\n \"status\": \"active\",\n \"goal\": \"Book a call with a specialist\",\n \"greeting\": \"Hi {first_name}! Quick question —\",\n \"model\": \"<string>\",\n \"max_turns\": 20,\n \"handoff_keywords\": [\n \"agent\",\n \"representative\"\n ],\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"inbox\": {\n \"mode\": \"handoff\",\n \"intent_threshold\": \"hot\",\n \"suppress_keywords\": [\n \"stop\",\n \"wrong number\"\n ]\n },\n \"sms\": {\n \"tone\": \"friendly\",\n \"creativity\": \"medium\",\n \"guardrails\": [\n \"Never quote a price\",\n \"Don't give legal advice\"\n ],\n \"max_length\": 320,\n \"knowledge\": \"<string>\",\n \"handoff_on_low_confidence\": true,\n \"handoff_after_turns\": 6,\n \"handoff_on_negative\": true,\n \"handoff_message\": \"<string>\",\n \"reply_delay_min_sec\": 2,\n \"reply_delay_max_sec\": 8,\n \"max_replies_per_day\": 10,\n \"capture_fields\": [\n \"email\",\n \"zip\"\n ],\n \"link_domain_id\": \"<string>\",\n \"conversion_keywords\": [\n \"yes\",\n \"interested\"\n ],\n \"conversion_on_agent_goal\": true,\n \"followup_enabled\": true,\n \"followup_count\": 2,\n \"followup_delay_hours\": 24,\n \"quiet_start_hour\": 21,\n \"quiet_end_hour\": 8,\n \"quiet_tz\": \"America/New_York\"\n },\n \"voice\": {\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"end_call\": true,\n \"speed\": 1,\n \"temperature\": 1,\n \"volume\": 1,\n \"responsiveness\": 1,\n \"interruption_sensitivity\": 1,\n \"enable_backchannel\": false,\n \"backchannel_frequency\": 0.8,\n \"reminder_trigger_ms\": 10000,\n \"end_call_after_silence_ms\": 600000,\n \"max_call_duration_ms\": 3600000,\n \"ambient_sound\": \"call-center\",\n \"boosted_keywords\": [\n \"Astrasend\",\n \"tadalafil\"\n ],\n \"model_temperature\": 0.7,\n \"voicemail_message\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.verbose.cx/v1/agents/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Debt-relief qualifier\",\n \"system_prompt\": \"You are a friendly assistant qualifying debt-relief leads…\",\n \"channel\": \"sms\",\n \"status\": \"active\",\n \"goal\": \"Book a call with a specialist\",\n \"greeting\": \"Hi {first_name}! Quick question —\",\n \"model\": \"<string>\",\n \"max_turns\": 20,\n \"handoff_keywords\": [\n \"agent\",\n \"representative\"\n ],\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"inbox\": {\n \"mode\": \"handoff\",\n \"intent_threshold\": \"hot\",\n \"suppress_keywords\": [\n \"stop\",\n \"wrong number\"\n ]\n },\n \"sms\": {\n \"tone\": \"friendly\",\n \"creativity\": \"medium\",\n \"guardrails\": [\n \"Never quote a price\",\n \"Don't give legal advice\"\n ],\n \"max_length\": 320,\n \"knowledge\": \"<string>\",\n \"handoff_on_low_confidence\": true,\n \"handoff_after_turns\": 6,\n \"handoff_on_negative\": true,\n \"handoff_message\": \"<string>\",\n \"reply_delay_min_sec\": 2,\n \"reply_delay_max_sec\": 8,\n \"max_replies_per_day\": 10,\n \"capture_fields\": [\n \"email\",\n \"zip\"\n ],\n \"link_domain_id\": \"<string>\",\n \"conversion_keywords\": [\n \"yes\",\n \"interested\"\n ],\n \"conversion_on_agent_goal\": true,\n \"followup_enabled\": true,\n \"followup_count\": 2,\n \"followup_delay_hours\": 24,\n \"quiet_start_hour\": 21,\n \"quiet_end_hour\": 8,\n \"quiet_tz\": \"America/New_York\"\n },\n \"voice\": {\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"end_call\": true,\n \"speed\": 1,\n \"temperature\": 1,\n \"volume\": 1,\n \"responsiveness\": 1,\n \"interruption_sensitivity\": 1,\n \"enable_backchannel\": false,\n \"backchannel_frequency\": 0.8,\n \"reminder_trigger_ms\": 10000,\n \"end_call_after_silence_ms\": 600000,\n \"max_call_duration_ms\": 3600000,\n \"ambient_sound\": \"call-center\",\n \"boosted_keywords\": [\n \"Astrasend\",\n \"tadalafil\"\n ],\n \"model_temperature\": 0.7,\n \"voicemail_message\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.verbose.cx/v1/agents/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Debt-relief qualifier\",\n \"system_prompt\": \"You are a friendly assistant qualifying debt-relief leads…\",\n \"channel\": \"sms\",\n \"status\": \"active\",\n \"goal\": \"Book a call with a specialist\",\n \"greeting\": \"Hi {first_name}! Quick question —\",\n \"model\": \"<string>\",\n \"max_turns\": 20,\n \"handoff_keywords\": [\n \"agent\",\n \"representative\"\n ],\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"inbox\": {\n \"mode\": \"handoff\",\n \"intent_threshold\": \"hot\",\n \"suppress_keywords\": [\n \"stop\",\n \"wrong number\"\n ]\n },\n \"sms\": {\n \"tone\": \"friendly\",\n \"creativity\": \"medium\",\n \"guardrails\": [\n \"Never quote a price\",\n \"Don't give legal advice\"\n ],\n \"max_length\": 320,\n \"knowledge\": \"<string>\",\n \"handoff_on_low_confidence\": true,\n \"handoff_after_turns\": 6,\n \"handoff_on_negative\": true,\n \"handoff_message\": \"<string>\",\n \"reply_delay_min_sec\": 2,\n \"reply_delay_max_sec\": 8,\n \"max_replies_per_day\": 10,\n \"capture_fields\": [\n \"email\",\n \"zip\"\n ],\n \"link_domain_id\": \"<string>\",\n \"conversion_keywords\": [\n \"yes\",\n \"interested\"\n ],\n \"conversion_on_agent_goal\": true,\n \"followup_enabled\": true,\n \"followup_count\": 2,\n \"followup_delay_hours\": 24,\n \"quiet_start_hour\": 21,\n \"quiet_end_hour\": 8,\n \"quiet_tz\": \"America/New_York\"\n },\n \"voice\": {\n \"voice_id\": \"11labs-Jenny\",\n \"language\": \"en-US\",\n \"end_call\": true,\n \"speed\": 1,\n \"temperature\": 1,\n \"volume\": 1,\n \"responsiveness\": 1,\n \"interruption_sensitivity\": 1,\n \"enable_backchannel\": false,\n \"backchannel_frequency\": 0.8,\n \"reminder_trigger_ms\": 10000,\n \"end_call_after_silence_ms\": 600000,\n \"max_call_duration_ms\": 3600000,\n \"ambient_sound\": \"call-center\",\n \"boosted_keywords\": [\n \"Astrasend\",\n \"tadalafil\"\n ],\n \"model_temperature\": 0.7,\n \"voicemail_message\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"ok": true,
"agent": {
"id": "a9c1f0d2-...",
"name": "Debt-relief qualifier",
"channel": "sms",
"status": "active",
"system_prompt": "<string>",
"goal": "<string>",
"greeting": "<string>",
"max_turns": 20,
"handoff_keywords": [
"<string>"
],
"voice_id": "<string>",
"voice": {
"voice_id": "11labs-Jenny",
"language": "en-US",
"end_call": true,
"speed": 1,
"temperature": 1,
"volume": 1,
"responsiveness": 1,
"interruption_sensitivity": 1,
"enable_backchannel": false,
"backchannel_frequency": 0.8,
"reminder_trigger_ms": 10000,
"end_call_after_silence_ms": 600000,
"max_call_duration_ms": 3600000,
"ambient_sound": "call-center",
"boosted_keywords": [
"Astrasend",
"tadalafil"
],
"model_temperature": 0.7,
"voicemail_message": "<string>"
},
"sms": {
"tone": "friendly",
"creativity": "medium",
"guardrails": [
"Never quote a price",
"Don't give legal advice"
],
"max_length": 320,
"knowledge": "<string>",
"handoff_on_low_confidence": true,
"handoff_after_turns": 6,
"handoff_on_negative": true,
"handoff_message": "<string>",
"reply_delay_min_sec": 2,
"reply_delay_max_sec": 8,
"max_replies_per_day": 10,
"capture_fields": [
"email",
"zip"
],
"link_domain_id": "<string>",
"conversion_keywords": [
"yes",
"interested"
],
"conversion_on_agent_goal": true,
"followup_enabled": true,
"followup_count": 2,
"followup_delay_hours": 24,
"quiet_start_hour": 21,
"quiet_end_hour": 8,
"quiet_tz": "America/New_York"
},
"inbox": {
"mode": "handoff",
"intent_threshold": "hot",
"suppress_keywords": [
"stop",
"wrong number"
]
},
"created_at": "2026-09-01T14:12:00Z"
}
}{
"ok": false,
"error": "list_id is required"
}{
"ok": false,
"error": "Invalid or missing API key"
}{
"ok": false,
"error": "This API key cannot create and edit.",
"required_scope": "write"
}{
"ok": false,
"error": "Not found"
}Authorizations
Your API key (as_live_…), created under Settings → API keys.
Path Parameters
The resource's unique id (UUID).
Body
Create or update an agent. SMS by default; set channel=voice and provide voice.voice_id for a voice agent. Beyond the persona, you can configure the full builder: guardrails, knowledge base, handoff rules, timing (sms), speech + call behavior (voice), and inbox routing.
Agent name.
"Debt-relief qualifier"
The agent's persona and instructions.
"You are a friendly assistant qualifying debt-relief leads…"
sms (default) or voice.
sms, voice "sms"
draft / active / paused.
"active"
What a successful conversation achieves.
"Book a call with a specialist"
Opening message/line.
"Hi {first_name}! Quick question —"
Model tier.
Max back-and-forth turns before wrapping up.
20
Contact phrases that force a human handoff.
["agent", "representative"]
Voice for a voice agent (or set voice.voice_id).
"11labs-Jenny"
Voice language (or set voice.language).
"en-US"
Inbox routing / human-handoff policy.
Show child attributes
Show child attributes
SMS agent behavior. All optional; unset fields use sensible defaults.
Show child attributes
Show child attributes
Voice agent build config. voice_id is required for a voice agent; the rest tune speech and call behavior.
Show child attributes
Show child attributes
Was this page helpful?