Skip to main content
POST
/
ai-agent
/
update
/
{id}
cURL
curl --request POST \
  --url https://api.callab.ai/v1/ai-agent/update/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "language": "en-US",
  "status": "<string>",
  "agent_flow": {},
  "agent_dynamic_variables": [
    {}
  ],
  "agent_post_call_outcomes": {},
  "prompt": "<string>",
  "prompt_type": "mono",
  "begin_message": "<string>",
  "voice_id": "<string>",
  "who_talks_first": "agent",
  "reminder_frequency_from": 50,
  "reminder_frequency_to": 2,
  "responsiveness": 0.5,
  "voice_speed": 1,
  "voice_temperature": 0.5,
  "background_audio_status": "disabled",
  "background_volume": 0.5,
  "background_audio_id": "<string>",
  "global_tools": {},
  "voice_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "voice_params": {},
  "is_denoiser_enabled": false,
  "denoiser_reduction_level": "moderate",
  "denoiser_boost_level": "none",
  "vad_min_speech_duration": 100,
  "vad_min_silence_duration": 100,
  "vad_activation_threshold": 100,
  "vad_prefix_padding_duration": 100,
  "vad_eos_timeout": 0,
  "is_amd_enabled": true,
  "is_amd_multilingual": false,
  "amd_timeout": 10000,
  "knowledge_base_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "chunker_mode": "stable",
  "is_turn_detection_enabled": true,
  "turn_detection_mode": "smart",
  "turn_detection_timeout": 3000,
  "workspace": "<string>"
}'
{
  "status": "ok",
  "message": "<string>",
  "data": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

ID of AI agent to update

Body

application/json

AI agent update data

Data required to create a new AI agent.

​
name
string
required
​
description
string
required
​
language
string
default:en-US
required

format ISO 639-1

​
status
string
required
​
prompt
string
required
​
begin_message
string
required
​
who_talks_first
enum<string>
default:agent
required
Available options:
agent,
human
​
reminder_frequency_from
integer
default:50
required
Required range: 30 <= x <= 200
​
reminder_frequency_to
integer
default:2
required
Required range: 1 <= x <= 5
​
responsiveness
number
default:0.5
required
Required range: 0 <= x <= 1
​
voice_speed
number
default:1
required
Required range: 0.5 <= x <= 2
​
voice_temperature
number
default:0.5
required
Required range: 0 <= x <= 1
​
background_audio_status
enum<string>
default:disabled
required
Available options:
disabled,
enabled
​
background_volume
number
default:0.5
required
Required range: 0 <= x <= 1
​
id
string<uuid>
​
agent_flow
object | null
​
agent_dynamic_variables
object[] | null
​
agent_post_call_outcomes
object | null
​
prompt_type
enum<string>
default:mono
Available options:
mono,
flow
​
voice_id
string | null
​
background_audio_id
string | null
​
global_tools
object | null
​
voice_uuid
string<uuid> | null
​
voice_params
object | null
​
is_denoiser_enabled
boolean | null
default:false
​
denoiser_reduction_level
enum<string> | null
default:moderate
Available options:
passive,
gentle,
moderate,
aggressive,
extreme
​
denoiser_boost_level
enum<string> | null
default:none
Available options:
none,
low,
medium,
high,
extreme
​
vad_min_speech_duration
integer | null
default:100
Required range: 100 <= x <= 3000
​
vad_min_silence_duration
integer | null
default:100
Required range: 100 <= x <= 3000
​
vad_activation_threshold
integer | null
default:100
Required range: 100 <= x <= 900
​
vad_prefix_padding_duration
integer | null
default:100
Required range: 100 <= x <= 3000
​
vad_eos_timeout
integer | null
default:0
Required range: 0 <= x <= 3000
​
is_amd_enabled
boolean | null
default:true
​
is_amd_multilingual
boolean | null
default:false
​
amd_timeout
integer | null
default:10000
Required range: 10000 <= x <= 60000
​
knowledge_base_id
string<uuid> | null
​
chunker_mode
enum<string> | null
default:stable
Available options:
fast,
balanced,
slow
​
is_turn_detection_enabled
boolean | null
default:true
​
turn_detection_mode
enum<string> | null
default:smart
Available options:
smart,
strict,
none
​
turn_detection_timeout
integer | null
default:3000
Required range: 500 <= x <= 7000
​
workspace
string | null

Response

200 - application/json

AI agent updated

​
status
enum<string>
Available options:
ok,
error
​
message
string
​
data
string