Update replaces the whole set

PUT /aiagents/{agent_id}/advanced-settings replaces the advanced settings, it does not merge them: every setting must be submitted on every update. A setting left out of the request body is submitted empty and its default is applied, so omitting a setting silently resets it. A request body without tools or without fine_tuning resets that whole group.

The safe update sequence is: read the current settings with the Get request, change the values you need, and send all of them back.

Two rules follow from the same replacement behaviour:

• a numeric setting submitted as 0 counts as not submitted, and is reset to its default, even where 0 is inside the accepted range. Submit the smallest value above 0 you need instead.
• the values a toggle enables are cleared whenever the toggle is submitted as false: scheduling clears scheduleLink, red_alert clears red_alert_webhook_url, background_audio clears office_noise_url and office_noise_volume, call_outcome_webhook clears calloutcome_webhook_url, and drop_on_silence clears silence_prompt_ms and silence_drop_ms.

Boolean settings must be submitted as JSON booleans (true/false), the strings "true"/"false" are also accepted. Any other value counts as false.

find_next_folder is reported in the transfer_call group but is submitted inside tools.