Skip to content

Update AI Agent Advanced Settings

PUT /aiagents/{agent_id}/advanced-settings

Update the advanced settings of the selected AI Agent, and the transfer routes assigned to it.

This request replaces the advanced settings, it does not merge them: all the tools and fine_tuning fields must be submitted on every update, a field left out is reset to its default. Read the current settings with Get AI Agent Advanced Settings, change what you need and submit all of them back.

The accepted values, the defaults and the settings cleared by a disabled toggle are listed in the Advanced Settings section above.

The reply returns the saved advanced settings, in the same shape as the Get request.

An agent_id that does not exist on the selected account is rejected by the AI Agent service, and fails the request with a 400 Bad Request.

Example: update the advanced settings

{
    "tools": {
        "scheduling": true,
        "scheduleLink": "https://calendly.com/example-realty",
        "send_email": false,
        "red_alert": true,
        "red_alert_webhook_url": "https://example.tld/webhook/red-alert",
        "background_audio": false,
        "office_noise_url": null,
        "office_noise_volume": 0.5,
        "call_outcome_webhook": true,
        "calloutcome_webhook_url": "https://example.tld/webhook/call-outcome",
        "find_next_folder": true
    },
    "fine_tuning": {
        "speed": 1,
        "temperature": 0.7,
        "no_barge_seconds": 2,
        "drop_on_silence": true,
        "silence_prompt_ms": 1000,
        "silence_drop_ms": 3000,
        "vad_method": "server_vad",
        "vad_prefix_padding_ms": 300,
        "vad_silence_duration_ms": 500,
        "vad_threshold": 0.1,
        "vad_eagerness": 0.6,
        "avanser_bnum_in_instr": false
    },
    "routes": [
        {
            "route_id": "298788",
            "aiTags": ["sales", "new-business"]
        },
        {
            "route_id": "337622",
            "deleted": true
        }
    ]
}