Skip to content

Update AI Agent Advanced Settings

Request

Security
HTTP_BASIC
Path
agent_idstring^[A-Za-z0-9_-]+$required

Agent ID containing letters, digits, hyphens, or underscores only.

Example:155
Bodyapplication/jsonrequired
toolsobject

Submit all tool values. Omitted fields reset to defaults; find_next_folder is submitted here.

fine_tuningobject

Submit all speech settings. Omitted fields reset to defaults.

routesArray of objects(AIAgentRouteAssignment)

Route assignments are merged: routes left out keep their current assignment.

curl -i -X PUT \
  -u '<username>:<password>' \
  https://tapi.avanser.com/v1/aiagents/155/advanced-settings \
  -H 'Content-Type: application/json' \
  -d '{
    "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
      }
    ]
  }'

Responses

Successful response

Bodyapplication/json
@transactionobject
responseobject
Response
{
  "@transaction": {
    "id": "c9220015e2f48bc7cf4b38186a7b2025",
    "account-id": "1234",
    "request": { … }
  },
  "response": {
    "message": "Advanced settings saved successfully",
    "code": 200,
    "advanced_settings": { … }
  }
}