curl --request PATCH \
--url https://api.example.com/agents/{agent_id}/tools/{instance_name} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"enabled": true,
"instance_name": "<string>",
"display_name": "<string>",
"description": "<string>",
"tool_type": "<string>",
"config": {
"description": "<string>",
"disallow_interruptions": true,
"requires_caller_consent": true,
"cost_unit": "<string>",
"goodbye_instructions": "<string>",
"goodbye_max_duration_ms": 10250,
"delete_room": true,
"wait_for_playout": true,
"record_end_reason": true,
"default_inter_digit_ms": 1000,
"inter_digit_ms": 1000,
"default_duration_ms": 1020,
"default_volume": 50,
"ivr_detection": true,
"allowed_digits": "<string>",
"max_sequence_length": 64,
"sip_trunk_id": "<string>",
"sip_trunk_address": "<string>",
"sip_headers": {},
"hold_audio_url": "<string>",
"hold_audio_loop": true,
"transfer_briefing_prompt": "<string>",
"transfer_briefing_voice_id": "<string>",
"transfer_announcement_prompt": "<string>",
"transfer_announcement": "<string>",
"transfer_timeout_s": 150,
"transfer_max_attempts": 5,
"fallback_target_name": "<string>",
"take_message_on_failure": true,
"target_directory": [
"<string>"
],
"target_number": "<string>",
"targets": [
{}
],
"play_dialtone": true,
"cold_transfer_announcement_prompt": "<string>",
"specialists": [
{}
],
"prefer_warm": true,
"handoff_announcement_prompt": "<string>",
"preserve_chat_ctx": true,
"chat_ctx_token_cap": 32128,
"service_account_email": "<string>",
"oauth_refresh_token_ref": "<string>",
"default_spreadsheet_id": "<string>",
"allowed_spreadsheet_ids": [
"<string>"
],
"max_rows_per_read": 5000,
"max_rows_per_write": 2500,
"result_summarization": true,
"spreadsheet_id": "<string>",
"sheet_name": "<string>",
"credentials_json": {},
"column_mapping": {},
"data_source_url": "<string>",
"auth_secret_ref": "<string>",
"query_template": "<string>",
"allowed_filters": [
"<string>"
],
"default_limit": 250,
"max_limit": 500,
"pii_redaction": true,
"cache_ttl_s": 43200,
"top_k_default": 10,
"similarity_threshold": 0.5,
"knowledge_namespace": "<string>",
"account_sid_ref": "<string>",
"auth_token_ref": "<string>",
"from_e164": "<string>",
"default_from": "<string>",
"allowed_destination_country_codes": [
"<string>"
],
"allow_send_to_caller_only": true,
"max_message_length": 1000,
"template_id": "<string>",
"template": "<string>",
"daily_quota_per_number": 500,
"require_explicit_consent": true,
"url": "<string>",
"url_allowlist": [
"<string>"
],
"allowed_methods": [
"<string>"
],
"default_headers": {},
"method": "<string>",
"headers": {},
"auth": {
"type": "none",
"token": "<string>",
"username": "<string>",
"password": "<string>",
"api_key_header": "X-API-Key",
"api_key_value": "<string>"
},
"signing_secret_ref": "<string>",
"timeout_s": 60,
"timeout_seconds": 60,
"max_retries": 5,
"max_body_bytes": 5000064,
"redact_response_pii": true,
"body_template": "<string>",
"retry_policy": {},
"simulate_latency_ms": 15000,
"simulate_error_rate": 0.5,
"expected_inputs": {},
"canned_response": "<string>",
"response_template": "<string>",
"latency_ms": 15000,
"handler_ref": "<string>",
"raw_schema": {},
"parameters_schema": {},
"execution_endpoint": "<string>",
"python_code": "<string>",
"rpc_method": "<string>",
"mcp_url": "<string>",
"mcp_allowlist": [
"<string>"
],
"bearer_token": "<string>",
"extra_headers": {},
"is_end_call": true,
"is_transfer": true,
"webhook_url": "<string>",
"auth_config": {}
},
"config_patch": {}
}
'