Preview merged configuration

GET

/v1/convai/agents/:agent_id/branches/:source_branch_id/merge-preview

GET

/v1/convai/agents/:agent_id/branches/:source_branch_id/merge-preview

$ curl -G https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz/branches/agtbrch_8901k4t9z5defmb8vh3e9361y7nj/merge-preview \
>      -d target_branch_id=agtbrch_8901k4t9z5defmb8vh3e9361y7nj \
>      -d force=true

1 {
2   "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
3   "name": "My Agent",
4   "conversation_config": {
5     "asr": {
6       "quality": "high",
7       "provider": "scribe_realtime",
8       "user_input_audio_format": "pcm_16000",
9       "keywords": [
10         "hello",
11         "world"
12       ]
13     },
14     "turn": {
15       "turn_timeout": 7,
16       "initial_wait_time": 1.1,
17       "silence_end_call_timeout": -1,
18       "turn_eagerness": "normal",
19       "spelling_patience": "auto",
20       "speculative_turn": false,
21       "retranscribe_on_turn_timeout": false,
22       "turn_model": "turn_v3",
23       "interruption_ignore_terms": [
24         "interruption_ignore_terms"
25       ],
26       "transcribe_on_disabled_interruptions": false,
27       "soft_timeout_config": {
28         "timeout_seconds": -1,
29         "message": "Hhmmmm...yeah."
30       }
31     },
32     "tts": {
33       "model_id": "eleven_turbo_v2",
34       "voice_id": "cjVigY5qzO86Huf0OWal",
35       "supported_voices": [
36         {
37           "label": "label",
38           "voice_id": "voice_id"
39         }
40       ],
41       "expressive_mode": true,
42       "suggested_audio_tags": [
43         {
44           "tag": "tag"
45         }
46       ],
47       "agent_output_audio_format": "pcm_16000",
48       "optimize_streaming_latency": 3,
49       "stability": 0.5,
50       "speed": 1,
51       "similarity_boost": 0.8,
52       "text_normalisation_type": "system_prompt",
53       "pronunciation_dictionary_locators": [
54         {
55           "pronunciation_dictionary_id": "pronunciation_dictionary_id",
56           "version_id": null
57         }
58       ],
59       "enable_phoneme_tags": true
60     },
61     "conversation": {
62       "text_only": true,
63       "max_duration_seconds": 600,
64       "client_events": [
65         "audio",
66         "interruption"
67       ],
68       "monitoring_enabled": true,
69       "monitoring_events": [
70         "conversation_initiation_metadata"
71       ],
72       "source_attribution": true
73     },
74     "language_presets": {
75       "key": {
76         "overrides": {
77           "asr": {
78             "keywords": [
79               "hello",
80               "world"
81             ]
82           },
83           "turn": {
84             "soft_timeout_config": {
85               "message": "Hhmmmm...yeah."
86             }
87           },
88           "tts": {
89             "voice_id": "cjVigY5qzO86Huf0OWal",
90             "stability": 0.5,
91             "speed": 1,
92             "similarity_boost": 0.8
93           },
94           "agent": {
95             "first_message": "Hello, how can I help you today?",
96             "language": "en",
97             "prompt": {
98               "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
99               "llm": "gemini-2.0-flash-001",
100               "tool_ids": [
101                 "tool_ids"
102               ],
103               "knowledge_base": [
104                 {
105                   "type": "file",
106                   "name": "My Knowledge Base",
107                   "id": "123",
108                   "usage_mode": "auto"
109                 }
110               ]
111             }
112           }
113         }
114       }
115     },
116     "agent": {
117       "first_message": "Hello, how can I help you today?",
118       "language": "en",
119       "hinglish_mode": true,
120       "dynamic_variables": {
121         "dynamic_variable_placeholders": {
122           "user_name": "John Doe"
123         }
124       },
125       "disable_first_message_interruptions": false,
126       "max_conversation_duration_message": "max_conversation_duration_message",
127       "prompt": {
128         "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
129         "llm": "gemini-2.0-flash-001",
130         "temperature": 0,
131         "max_tokens": -1,
132         "tool_ids": [
133           "tool_ids"
134         ],
135         "built_in_tools": {
136           "end_call": {
137             "name": "end_call",
138             "params": {
139               "system_tool_type": "end_call"
140             },
141             "type": "system",
142             "description": "",
143             "assignments": [
144               {
145                 "dynamic_variable": "user_name",
146                 "value_path": "user.name",
147                 "source": "response",
148                 "sanitize": false,
149                 "preserve_native_type": false
150               }
151             ]
152           },
153           "language_detection": {
154             "name": "end_call",
155             "params": {
156               "system_tool_type": "end_call"
157             },
158             "type": "system",
159             "description": "",
160             "assignments": [
161               {
162                 "dynamic_variable": "user_name",
163                 "value_path": "user.name",
164                 "source": "response",
165                 "sanitize": false,
166                 "preserve_native_type": false
167               }
168             ]
169           },
170           "transfer_to_agent": {
171             "name": "end_call",
172             "params": {
173               "system_tool_type": "end_call"
174             },
175             "type": "system",
176             "description": "",
177             "assignments": [
178               {
179                 "dynamic_variable": "user_name",
180                 "value_path": "user.name",
181                 "source": "response",
182                 "sanitize": false,
183                 "preserve_native_type": false
184               }
185             ]
186           },
187           "transfer_to_number": {
188             "name": "end_call",
189             "params": {
190               "system_tool_type": "end_call"
191             },
192             "type": "system",
193             "description": "",
194             "assignments": [
195               {
196                 "dynamic_variable": "user_name",
197                 "value_path": "user.name",
198                 "source": "response",
199                 "sanitize": false,
200                 "preserve_native_type": false
201               }
202             ]
203           },
204           "skip_turn": {
205             "name": "end_call",
206             "params": {
207               "system_tool_type": "end_call"
208             },
209             "type": "system",
210             "description": "",
211             "assignments": [
212               {
213                 "dynamic_variable": "user_name",
214                 "value_path": "user.name",
215                 "source": "response",
216                 "sanitize": false,
217                 "preserve_native_type": false
218               }
219             ]
220           },
221           "play_keypad_touch_tone": {
222             "name": "end_call",
223             "params": {
224               "system_tool_type": "end_call"
225             },
226             "type": "system",
227             "description": "",
228             "assignments": [
229               {
230                 "dynamic_variable": "user_name",
231                 "value_path": "user.name",
232                 "source": "response",
233                 "sanitize": false,
234                 "preserve_native_type": false
235               }
236             ]
237           },
238           "voicemail_detection": {
239             "name": "end_call",
240             "params": {
241               "system_tool_type": "end_call"
242             },
243             "type": "system",
244             "description": "",
245             "assignments": [
246               {
247                 "dynamic_variable": "user_name",
248                 "value_path": "user.name",
249                 "source": "response",
250                 "sanitize": false,
251                 "preserve_native_type": false
252               }
253             ]
254           }
255         },
256         "knowledge_base": [
257           {
258             "type": "file",
259             "name": "My Knowledge Base",
260             "id": "123",
261             "usage_mode": "auto"
262           }
263         ],
264         "rag": {
265           "max_vector_distance": 0.5,
266           "max_retrieved_rag_chunks_count": 5
267         }
268       }
269     }
270   },
271   "metadata": {
272     "created_at_unix_secs": 1,
273     "updated_at_unix_secs": 1
274   },
275   "platform_settings": {
276     "evaluation": {
277       "criteria": [
278         {
279           "id": "1234567890",
280           "name": "Customer satisfaction check",
281           "conversation_goal_prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
282           "use_knowledge_base": false,
283           "scope": "conversation"
284         }
285       ]
286     },
287     "widget": {
288       "variant": "tiny",
289       "placement": "top-left",
290       "expandable": "never",
291       "avatar": {
292         "type": "orb",
293         "color_1": "#2792dc",
294         "color_2": "#9ce6e6"
295       },
296       "feedback_mode": "none",
297       "bg_color": "bg_color",
298       "text_color": "text_color",
299       "btn_color": "btn_color",
300       "btn_text_color": "btn_text_color",
301       "border_color": "border_color",
302       "focus_color": "focus_color",
303       "border_radius": 1,
304       "btn_radius": 1,
305       "action_text": "action_text",
306       "start_call_text": "start_call_text",
307       "end_call_text": "end_call_text",
308       "expand_text": "expand_text",
309       "listening_text": "listening_text",
310       "speaking_text": "speaking_text",
311       "shareable_page_text": "shareable_page_text",
312       "shareable_page_show_terms": true,
313       "terms_text": "terms_text",
314       "terms_html": "terms_html",
315       "terms_key": "terms_key",
316       "show_avatar_when_collapsed": true,
317       "disable_banner": true,
318       "override_link": "override_link",
319       "markdown_link_allowed_hosts": [
320         {
321           "hostname": "hostname"
322         }
323       ],
324       "markdown_link_include_www": true,
325       "markdown_link_allow_http": true,
326       "mic_muting_enabled": true,
327       "transcript_enabled": true,
328       "text_input_enabled": true,
329       "conversation_mode_toggle_enabled": true,
330       "default_expanded": true,
331       "always_expanded": true,
332       "dismissible": true,
333       "show_agent_status": true,
334       "show_conversation_id": true,
335       "strip_audio_tags": true,
336       "syntax_highlight_theme": "light",
337       "language_selector": false,
338       "supports_text_only": true,
339       "custom_avatar_path": "https://example.com/avatar.png",
340       "language_presets": {
341         "key": {}
342       }
343     },
344     "data_collection": {
345       "key": {
346         "type": "string",
347         "description": "My property",
348         "is_system_provided": false,
349         "dynamic_variable": "",
350         "constant_value": ""
351       }
352     },
353     "data_collection_scopes": {
354       "key": "conversation"
355     },
356     "overrides": {
357       "custom_llm_extra_body": true,
358       "enable_conversation_initiation_client_data_from_webhook": true,
359       "enable_starting_workflow_node_id_from_client": true
360     },
361     "workspace_overrides": {
362       "conversation_initiation_client_data_webhook": {
363         "url": "https://example.com/webhook",
364         "request_headers": {
365           "Content-Type": "application/json"
366         }
367       }
368     },
369     "testing": {
370       "attached_tests": [
371         {
372           "test_id": "test_123",
373           "workflow_node_id": "node_abc"
374         },
375         {
376           "test_id": "test_456"
377         }
378       ]
379     },
380     "archived": true,
381     "guardrails": {
382       "version": "1"
383     },
384     "summary_language": "summary_language",
385     "auth": {
386       "enable_auth": true,
387       "allowlist": [
388         {
389           "hostname": "https://example.com"
390         }
391       ],
392       "require_origin_header": true,
393       "shareable_token": "1234567890"
394     },
395     "call_limits": {
396       "agent_concurrency_limit": -1,
397       "daily_limit": 100000,
398       "bursting_enabled": true
399     },
400     "privacy": {
401       "record_voice": true,
402       "retention_days": -1,
403       "delete_transcript_and_pii": false,
404       "delete_audio": false,
405       "apply_to_existing_conversations": false,
406       "zero_retention_mode": false
407     },
408     "trust_context": "unknown",
409     "analysis_llm": "gpt-4o-mini",
410     "safety": {
411       "is_blocked_ivc": true,
412       "is_blocked_non_ivc": true,
413       "ignore_safety_evaluation": true
414     }
415   },
416   "phone_numbers": [
417     {
418       "provider": "exotel",
419       "label": "Exotel Outbound",
420       "phone_number": "+919999999999",
421       "phone_number_id": "phnum_X3Pbu5gP6NNKBscdCdwB",
422       "assigned_agent": {
423         "agent_id": "F3Pbu5gP6NNKBscdCdwB",
424         "agent_name": "My Agent"
425       }
426     }
427   ],
428   "whatsapp_accounts": [
429     {
430       "business_account_id": "business_account_id",
431       "phone_number_id": "phone_number_id",
432       "business_account_name": "business_account_name",
433       "phone_number_name": "phone_number_name",
434       "phone_number": "phone_number",
435       "assigned_agent_id": "assigned_agent_id",
436       "enable_messaging": true,
437       "enable_audio_message_response": true,
438       "assigned_agent_name": "assigned_agent_name",
439       "is_token_expired": true
440     }
441   ],
442   "workflow": {
443     "edges": {
444       "entry_to_tool_a": {
445         "source": "entry_node",
446         "target": "tool_node_a",
447         "forward_condition": {
448           "type": "llm",
449           "condition": "User's last message contains a question about our pricing.",
450           "label": null
451         },
452         "backward_condition": {
453           "type": "expression",
454           "expression": {
455             "type": "and_operator",
456             "children": []
457           },
458           "label": null
459         }
460       },
461       "start_to_entry": {
462         "source": "start_node",
463         "target": "entry_node",
464         "forward_condition": {
465           "type": "unconditional",
466           "label": null
467         },
468         "backward_condition": {
469           "type": "expression",
470           "expression": {
471             "type": "and_operator",
472             "children": []
473           },
474           "label": null
475         }
476       },
477       "tool_a_to_failure": {
478         "source": "tool_node_a",
479         "target": "failure_node",
480         "forward_condition": {
481           "type": "result",
482           "successful": true,
483           "label": null
484         },
485         "backward_condition": {
486           "type": "expression",
487           "expression": {
488             "type": "and_operator",
489             "children": []
490           },
491           "label": null
492         }
493       },
494       "tool_a_to_tool_b": {
495         "source": "tool_node_a",
496         "target": "tool_node_b",
497         "forward_condition": {
498           "type": "result",
499           "successful": true,
500           "label": null
501         },
502         "backward_condition": {
503           "type": "expression",
504           "expression": {
505             "type": "and_operator",
506             "children": []
507           },
508           "label": null
509         }
510       },
511       "tool_b_to_agent_transfer": {
512         "source": "tool_node_b",
513         "target": "success_transfer",
514         "forward_condition": {
515           "type": "unconditional",
516           "label": null
517         },
518         "backward_condition": {
519           "type": "expression",
520           "expression": {
521             "type": "and_operator",
522             "children": []
523           },
524           "label": null
525         }
526       },
527       "tool_b_to_conversation": {
528         "source": "tool_node_b",
529         "target": "success_conversation",
530         "forward_condition": {
531           "type": "llm",
532           "condition": "User's last message contains a question about our pricing.",
533           "label": null
534         },
535         "backward_condition": {
536           "type": "expression",
537           "expression": {
538             "type": "and_operator",
539             "children": []
540           },
541           "label": null
542         }
543       },
544       "tool_b_to_end": {
545         "source": "tool_node_b",
546         "target": "success_end",
547         "forward_condition": {
548           "type": "llm",
549           "condition": "User's last message contains a question about our pricing.",
550           "label": null
551         },
552         "backward_condition": {
553           "type": "expression",
554           "expression": {
555             "type": "and_operator",
556             "children": []
557           },
558           "label": null
559         }
560       },
561       "tool_b_to_phone": {
562         "source": "tool_node_b",
563         "target": "success_phone",
564         "forward_condition": {
565           "type": "expression",
566           "expression": {
567             "type": "and_operator",
568             "children": []
569           },
570           "label": null
571         },
572         "backward_condition": {
573           "type": "expression",
574           "expression": {
575             "type": "and_operator",
576             "children": []
577           },
578           "label": null
579         }
580       }
581     },
582     "nodes": {
583       "entry_node": {
584         "type": "override_agent",
585         "additional_knowledge_base": [
586           {
587             "type": "file",
588             "name": "My Knowledge Base",
589             "id": "123",
590             "usage_mode": "auto"
591           }
592         ],
593         "additional_prompt": "additional_prompt",
594         "additional_tool_ids": [
595           "additional_tool_ids"
596         ],
597         "conversation_config": {
598           "asr": {
599             "quality": "high",
600             "provider": "scribe_realtime",
601             "user_input_audio_format": "pcm_16000",
602             "keywords": [
603               "hello",
604               "world"
605             ]
606           },
607           "turn": {
608             "turn_timeout": 7,
609             "silence_end_call_timeout": -1,
610             "turn_eagerness": "normal",
611             "spelling_patience": "auto",
612             "speculative_turn": false,
613             "retranscribe_on_turn_timeout": false,
614             "turn_model": "turn_v3",
615             "interruption_ignore_terms": [
616               "interruption_ignore_terms"
617             ],
618             "transcribe_on_disabled_interruptions": false,
619             "soft_timeout_config": {
620               "timeout_seconds": -1,
621               "message": "Hhmmmm...yeah.",
622               "use_llm_generated_message": false
623             }
624           },
625           "tts": {
626             "model_id": "eleven_turbo_v2",
627             "voice_id": "cjVigY5qzO86Huf0OWal",
628             "agent_output_audio_format": "pcm_16000",
629             "optimize_streaming_latency": 3,
630             "stability": 0.5,
631             "speed": 1,
632             "similarity_boost": 0.8,
633             "pronunciation_dictionary_locators": [
634               {
635                 "pronunciation_dictionary_id": "pronunciation_dictionary_id",
636                 "version_id": null
637               }
638             ]
639           },
640           "conversation": {
641             "max_duration_seconds": 600,
642             "client_events": [
643               "audio",
644               "interruption"
645             ]
646           },
647           "agent": {
648             "first_message": "Hello, how can I help you today?",
649             "language": "en",
650             "dynamic_variables": {
651               "dynamic_variable_placeholders": {
652                 "user_name": "John Doe"
653               }
654             },
655             "disable_first_message_interruptions": false,
656             "prompt": {
657               "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
658               "llm": "gemini-2.0-flash-001",
659               "temperature": 0,
660               "max_tokens": -1,
661               "tool_ids": [
662                 "tool_ids"
663               ],
664               "built_in_tools": {
665                 "end_call": {
666                   "name": "end_call",
667                   "params": {
668                     "system_tool_type": "end_call"
669                   },
670                   "type": "system",
671                   "description": "",
672                   "assignments": [
673                     {
674                       "dynamic_variable": "user_name",
675                       "value_path": "user.name",
676                       "source": "response",
677                       "sanitize": false,
678                       "preserve_native_type": false
679                     }
680                   ]
681                 },
682                 "language_detection": {
683                   "name": "end_call",
684                   "params": {
685                     "system_tool_type": "end_call"
686                   },
687                   "type": "system",
688                   "description": "",
689                   "assignments": [
690                     {
691                       "dynamic_variable": "user_name",
692                       "value_path": "user.name",
693                       "source": "response",
694                       "sanitize": false,
695                       "preserve_native_type": false
696                     }
697                   ]
698                 },
699                 "transfer_to_agent": {
700                   "name": "end_call",
701                   "params": {
702                     "system_tool_type": "end_call"
703                   },
704                   "type": "system",
705                   "description": "",
706                   "assignments": [
707                     {
708                       "dynamic_variable": "user_name",
709                       "value_path": "user.name",
710                       "source": "response",
711                       "sanitize": false,
712                       "preserve_native_type": false
713                     }
714                   ]
715                 },
716                 "transfer_to_number": {
717                   "name": "end_call",
718                   "params": {
719                     "system_tool_type": "end_call"
720                   },
721                   "type": "system",
722                   "description": "",
723                   "assignments": [
724                     {
725                       "dynamic_variable": "user_name",
726                       "value_path": "user.name",
727                       "source": "response",
728                       "sanitize": false,
729                       "preserve_native_type": false
730                     }
731                   ]
732                 },
733                 "skip_turn": {
734                   "name": "end_call",
735                   "params": {
736                     "system_tool_type": "end_call"
737                   },
738                   "type": "system",
739                   "description": "",
740                   "assignments": [
741                     {
742                       "dynamic_variable": "user_name",
743                       "value_path": "user.name",
744                       "source": "response",
745                       "sanitize": false,
746                       "preserve_native_type": false
747                     }
748                   ]
749                 },
750                 "play_keypad_touch_tone": {
751                   "name": "end_call",
752                   "params": {
753                     "system_tool_type": "end_call"
754                   },
755                   "type": "system",
756                   "description": "",
757                   "assignments": [
758                     {
759                       "dynamic_variable": "user_name",
760                       "value_path": "user.name",
761                       "source": "response",
762                       "sanitize": false,
763                       "preserve_native_type": false
764                     }
765                   ]
766                 },
767                 "voicemail_detection": {
768                   "name": "end_call",
769                   "params": {
770                     "system_tool_type": "end_call"
771                   },
772                   "type": "system",
773                   "description": "",
774                   "assignments": [
775                     {
776                       "dynamic_variable": "user_name",
777                       "value_path": "user.name",
778                       "source": "response",
779                       "sanitize": false,
780                       "preserve_native_type": false
781                     }
782                   ]
783                 }
784               },
785               "knowledge_base": [
786                 {
787                   "type": "file",
788                   "name": "My Knowledge Base",
789                   "id": "123",
790                   "usage_mode": "auto"
791                 }
792               ],
793               "tools": [
794                 {
795                   "type": "api_integration_webhook",
796                   "api_integration_connection_id": "api_integration_connection_id",
797                   "api_integration_id": "api_integration_id",
798                   "assignments": [
799                     {
800                       "dynamic_variable": "user_name",
801                       "value_path": "user.name",
802                       "source": "response",
803                       "sanitize": false,
804                       "preserve_native_type": false
805                     }
806                   ],
807                   "description": "description",
808                   "disable_interruptions": true,
809                   "dynamic_variables": {
810                     "dynamic_variable_placeholders": {
811                       "user_name": "John Doe"
812                     }
813                   },
814                   "execution_mode": "immediate",
815                   "name": "name",
816                   "pre_tool_speech": "auto",
817                   "response_timeout_secs": 1,
818                   "tool_call_sound_behavior": "auto",
819                   "tool_error_handling_mode": "auto",
820                   "tool_version": "tool_version",
821                   "force_pre_tool_speech": true,
822                   "api_schema_overrides": null,
823                   "tool_call_sound": null
824                 }
825               ]
826             }
827           }
828         },
829         "edge_order": [
830           "edge_order"
831         ],
832         "entry_behavior": "generate_immediately",
833         "label": "label",
834         "position": {
835           "x": 1.1,
836           "y": 1.1
837         }
838       },
839       "failure_node": {
840         "type": "override_agent",
841         "additional_knowledge_base": [
842           {
843             "type": "file",
844             "name": "My Knowledge Base",
845             "id": "123",
846             "usage_mode": "auto"
847           }
848         ],
849         "additional_prompt": "additional_prompt",
850         "additional_tool_ids": [
851           "additional_tool_ids"
852         ],
853         "conversation_config": {
854           "asr": {
855             "quality": "high",
856             "provider": "scribe_realtime",
857             "user_input_audio_format": "pcm_16000",
858             "keywords": [
859               "hello",
860               "world"
861             ]
862           },
863           "turn": {
864             "turn_timeout": 7,
865             "silence_end_call_timeout": -1,
866             "turn_eagerness": "normal",
867             "spelling_patience": "auto",
868             "speculative_turn": false,
869             "retranscribe_on_turn_timeout": false,
870             "turn_model": "turn_v3",
871             "interruption_ignore_terms": [
872               "interruption_ignore_terms"
873             ],
874             "transcribe_on_disabled_interruptions": false,
875             "soft_timeout_config": {
876               "timeout_seconds": -1,
877               "message": "Hhmmmm...yeah.",
878               "use_llm_generated_message": false
879             }
880           },
881           "tts": {
882             "model_id": "eleven_turbo_v2",
883             "voice_id": "cjVigY5qzO86Huf0OWal",
884             "agent_output_audio_format": "pcm_16000",
885             "optimize_streaming_latency": 3,
886             "stability": 0.5,
887             "speed": 1,
888             "similarity_boost": 0.8,
889             "pronunciation_dictionary_locators": [
890               {
891                 "pronunciation_dictionary_id": "pronunciation_dictionary_id",
892                 "version_id": null
893               }
894             ]
895           },
896           "conversation": {
897             "max_duration_seconds": 600,
898             "client_events": [
899               "audio",
900               "interruption"
901             ]
902           },
903           "agent": {
904             "first_message": "Hello, how can I help you today?",
905             "language": "en",
906             "dynamic_variables": {
907               "dynamic_variable_placeholders": {
908                 "user_name": "John Doe"
909               }
910             },
911             "disable_first_message_interruptions": false,
912             "prompt": {
913               "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
914               "llm": "gemini-2.0-flash-001",
915               "temperature": 0,
916               "max_tokens": -1,
917               "tool_ids": [
918                 "tool_ids"
919               ],
920               "built_in_tools": {
921                 "end_call": {
922                   "name": "end_call",
923                   "params": {
924                     "system_tool_type": "end_call"
925                   },
926                   "type": "system",
927                   "description": "",
928                   "assignments": [
929                     {
930                       "dynamic_variable": "user_name",
931                       "value_path": "user.name",
932                       "source": "response",
933                       "sanitize": false,
934                       "preserve_native_type": false
935                     }
936                   ]
937                 },
938                 "language_detection": {
939                   "name": "end_call",
940                   "params": {
941                     "system_tool_type": "end_call"
942                   },
943                   "type": "system",
944                   "description": "",
945                   "assignments": [
946                     {
947                       "dynamic_variable": "user_name",
948                       "value_path": "user.name",
949                       "source": "response",
950                       "sanitize": false,
951                       "preserve_native_type": false
952                     }
953                   ]
954                 },
955                 "transfer_to_agent": {
956                   "name": "end_call",
957                   "params": {
958                     "system_tool_type": "end_call"
959                   },
960                   "type": "system",
961                   "description": "",
962                   "assignments": [
963                     {
964                       "dynamic_variable": "user_name",
965                       "value_path": "user.name",
966                       "source": "response",
967                       "sanitize": false,
968                       "preserve_native_type": false
969                     }
970                   ]
971                 },
972                 "transfer_to_number": {
973                   "name": "end_call",
974                   "params": {
975                     "system_tool_type": "end_call"
976                   },
977                   "type": "system",
978                   "description": "",
979                   "assignments": [
980                     {
981                       "dynamic_variable": "user_name",
982                       "value_path": "user.name",
983                       "source": "response",
984                       "sanitize": false,
985                       "preserve_native_type": false
986                     }
987                   ]
988                 },
989                 "skip_turn": {
990                   "name": "end_call",
991                   "params": {
992                     "system_tool_type": "end_call"
993                   },
994                   "type": "system",
995                   "description": "",
996                   "assignments": [
997                     {
998                       "dynamic_variable": "user_name",
999                       "value_path": "user.name",
1000                       "source": "response",
1001                       "sanitize": false,
1002                       "preserve_native_type": false
1003                     }
1004                   ]
1005                 },
1006                 "play_keypad_touch_tone": {
1007                   "name": "end_call",
1008                   "params": {
1009                     "system_tool_type": "end_call"
1010                   },
1011                   "type": "system",
1012                   "description": "",
1013                   "assignments": [
1014                     {
1015                       "dynamic_variable": "user_name",
1016                       "value_path": "user.name",
1017                       "source": "response",
1018                       "sanitize": false,
1019                       "preserve_native_type": false
1020                     }
1021                   ]
1022                 },
1023                 "voicemail_detection": {
1024                   "name": "end_call",
1025                   "params": {
1026                     "system_tool_type": "end_call"
1027                   },
1028                   "type": "system",
1029                   "description": "",
1030                   "assignments": [
1031                     {
1032                       "dynamic_variable": "user_name",
1033                       "value_path": "user.name",
1034                       "source": "response",
1035                       "sanitize": false,
1036                       "preserve_native_type": false
1037                     }
1038                   ]
1039                 }
1040               },
1041               "knowledge_base": [
1042                 {
1043                   "type": "file",
1044                   "name": "My Knowledge Base",
1045                   "id": "123",
1046                   "usage_mode": "auto"
1047                 }
1048               ],
1049               "tools": [
1050                 {
1051                   "type": "api_integration_webhook",
1052                   "api_integration_connection_id": "api_integration_connection_id",
1053                   "api_integration_id": "api_integration_id",
1054                   "assignments": [
1055                     {
1056                       "dynamic_variable": "user_name",
1057                       "value_path": "user.name",
1058                       "source": "response",
1059                       "sanitize": false,
1060                       "preserve_native_type": false
1061                     }
1062                   ],
1063                   "description": "description",
1064                   "disable_interruptions": true,
1065                   "dynamic_variables": {
1066                     "dynamic_variable_placeholders": {
1067                       "user_name": "John Doe"
1068                     }
1069                   },
1070                   "execution_mode": "immediate",
1071                   "name": "name",
1072                   "pre_tool_speech": "auto",
1073                   "response_timeout_secs": 1,
1074                   "tool_call_sound_behavior": "auto",
1075                   "tool_error_handling_mode": "auto",
1076                   "tool_version": "tool_version",
1077                   "force_pre_tool_speech": true,
1078                   "api_schema_overrides": null,
1079                   "tool_call_sound": null
1080                 }
1081               ]
1082             }
1083           }
1084         },
1085         "edge_order": [
1086           "edge_order"
1087         ],
1088         "entry_behavior": "generate_immediately",
1089         "label": "label",
1090         "position": {
1091           "x": 1.1,
1092           "y": 1.1
1093         }
1094       },
1095       "start_node": {
1096         "type": "start",
1097         "edge_order": [
1098           "edge_order"
1099         ],
1100         "position": {
1101           "x": 1.1,
1102           "y": 1.1
1103         }
1104       },
1105       "success_conversation": {
1106         "type": "override_agent",
1107         "additional_knowledge_base": [
1108           {
1109             "type": "file",
1110             "name": "My Knowledge Base",
1111             "id": "123",
1112             "usage_mode": "auto"
1113           }
1114         ],
1115         "additional_prompt": "additional_prompt",
1116         "additional_tool_ids": [
1117           "additional_tool_ids"
1118         ],
1119         "conversation_config": {
1120           "asr": {
1121             "quality": "high",
1122             "provider": "scribe_realtime",
1123             "user_input_audio_format": "pcm_16000",
1124             "keywords": [
1125               "hello",
1126               "world"
1127             ]
1128           },
1129           "turn": {
1130             "turn_timeout": 7,
1131             "silence_end_call_timeout": -1,
1132             "turn_eagerness": "normal",
1133             "spelling_patience": "auto",
1134             "speculative_turn": false,
1135             "retranscribe_on_turn_timeout": false,
1136             "turn_model": "turn_v3",
1137             "interruption_ignore_terms": [
1138               "interruption_ignore_terms"
1139             ],
1140             "transcribe_on_disabled_interruptions": false,
1141             "soft_timeout_config": {
1142               "timeout_seconds": -1,
1143               "message": "Hhmmmm...yeah.",
1144               "use_llm_generated_message": false
1145             }
1146           },
1147           "tts": {
1148             "model_id": "eleven_turbo_v2",
1149             "voice_id": "cjVigY5qzO86Huf0OWal",
1150             "agent_output_audio_format": "pcm_16000",
1151             "optimize_streaming_latency": 3,
1152             "stability": 0.5,
1153             "speed": 1,
1154             "similarity_boost": 0.8,
1155             "pronunciation_dictionary_locators": [
1156               {
1157                 "pronunciation_dictionary_id": "pronunciation_dictionary_id",
1158                 "version_id": null
1159               }
1160             ]
1161           },
1162           "conversation": {
1163             "max_duration_seconds": 600,
1164             "client_events": [
1165               "audio",
1166               "interruption"
1167             ]
1168           },
1169           "agent": {
1170             "first_message": "Hello, how can I help you today?",
1171             "language": "en",
1172             "dynamic_variables": {
1173               "dynamic_variable_placeholders": {
1174                 "user_name": "John Doe"
1175               }
1176             },
1177             "disable_first_message_interruptions": false,
1178             "prompt": {
1179               "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
1180               "llm": "gemini-2.0-flash-001",
1181               "temperature": 0,
1182               "max_tokens": -1,
1183               "tool_ids": [
1184                 "tool_ids"
1185               ],
1186               "built_in_tools": {
1187                 "end_call": {
1188                   "name": "end_call",
1189                   "params": {
1190                     "system_tool_type": "end_call"
1191                   },
1192                   "type": "system",
1193                   "description": "",
1194                   "assignments": [
1195                     {
1196                       "dynamic_variable": "user_name",
1197                       "value_path": "user.name",
1198                       "source": "response",
1199                       "sanitize": false,
1200                       "preserve_native_type": false
1201                     }
1202                   ]
1203                 },
1204                 "language_detection": {
1205                   "name": "end_call",
1206                   "params": {
1207                     "system_tool_type": "end_call"
1208                   },
1209                   "type": "system",
1210                   "description": "",
1211                   "assignments": [
1212                     {
1213                       "dynamic_variable": "user_name",
1214                       "value_path": "user.name",
1215                       "source": "response",
1216                       "sanitize": false,
1217                       "preserve_native_type": false
1218                     }
1219                   ]
1220                 },
1221                 "transfer_to_agent": {
1222                   "name": "end_call",
1223                   "params": {
1224                     "system_tool_type": "end_call"
1225                   },
1226                   "type": "system",
1227                   "description": "",
1228                   "assignments": [
1229                     {
1230                       "dynamic_variable": "user_name",
1231                       "value_path": "user.name",
1232                       "source": "response",
1233                       "sanitize": false,
1234                       "preserve_native_type": false
1235                     }
1236                   ]
1237                 },
1238                 "transfer_to_number": {
1239                   "name": "end_call",
1240                   "params": {
1241                     "system_tool_type": "end_call"
1242                   },
1243                   "type": "system",
1244                   "description": "",
1245                   "assignments": [
1246                     {
1247                       "dynamic_variable": "user_name",
1248                       "value_path": "user.name",
1249                       "source": "response",
1250                       "sanitize": false,
1251                       "preserve_native_type": false
1252                     }
1253                   ]
1254                 },
1255                 "skip_turn": {
1256                   "name": "end_call",
1257                   "params": {
1258                     "system_tool_type": "end_call"
1259                   },
1260                   "type": "system",
1261                   "description": "",
1262                   "assignments": [
1263                     {
1264                       "dynamic_variable": "user_name",
1265                       "value_path": "user.name",
1266                       "source": "response",
1267                       "sanitize": false,
1268                       "preserve_native_type": false
1269                     }
1270                   ]
1271                 },
1272                 "play_keypad_touch_tone": {
1273                   "name": "end_call",
1274                   "params": {
1275                     "system_tool_type": "end_call"
1276                   },
1277                   "type": "system",
1278                   "description": "",
1279                   "assignments": [
1280                     {
1281                       "dynamic_variable": "user_name",
1282                       "value_path": "user.name",
1283                       "source": "response",
1284                       "sanitize": false,
1285                       "preserve_native_type": false
1286                     }
1287                   ]
1288                 },
1289                 "voicemail_detection": {
1290                   "name": "end_call",
1291                   "params": {
1292                     "system_tool_type": "end_call"
1293                   },
1294                   "type": "system",
1295                   "description": "",
1296                   "assignments": [
1297                     {
1298                       "dynamic_variable": "user_name",
1299                       "value_path": "user.name",
1300                       "source": "response",
1301                       "sanitize": false,
1302                       "preserve_native_type": false
1303                     }
1304                   ]
1305                 }
1306               },
1307               "knowledge_base": [
1308                 {
1309                   "type": "file",
1310                   "name": "My Knowledge Base",
1311                   "id": "123",
1312                   "usage_mode": "auto"
1313                 }
1314               ],
1315               "tools": [
1316                 {
1317                   "type": "api_integration_webhook",
1318                   "api_integration_connection_id": "api_integration_connection_id",
1319                   "api_integration_id": "api_integration_id",
1320                   "assignments": [
1321                     {
1322                       "dynamic_variable": "user_name",
1323                       "value_path": "user.name",
1324                       "source": "response",
1325                       "sanitize": false,
1326                       "preserve_native_type": false
1327                     }
1328                   ],
1329                   "description": "description",
1330                   "disable_interruptions": true,
1331                   "dynamic_variables": {
1332                     "dynamic_variable_placeholders": {
1333                       "user_name": "John Doe"
1334                     }
1335                   },
1336                   "execution_mode": "immediate",
1337                   "name": "name",
1338                   "pre_tool_speech": "auto",
1339                   "response_timeout_secs": 1,
1340                   "tool_call_sound_behavior": "auto",
1341                   "tool_error_handling_mode": "auto",
1342                   "tool_version": "tool_version",
1343                   "force_pre_tool_speech": true,
1344                   "api_schema_overrides": null,
1345                   "tool_call_sound": null
1346                 }
1347               ]
1348             }
1349           }
1350         },
1351         "edge_order": [
1352           "edge_order"
1353         ],
1354         "entry_behavior": "generate_immediately",
1355         "label": "label",
1356         "position": {
1357           "x": 1.1,
1358           "y": 1.1
1359         }
1360       },
1361       "success_end": {
1362         "type": "end",
1363         "edge_order": [
1364           "edge_order"
1365         ],
1366         "position": {
1367           "x": 1.1,
1368           "y": 1.1
1369         }
1370       },
1371       "success_phone": {
1372         "type": "phone_number",
1373         "custom_sip_headers": [
1374           {
1375             "type": "dynamic",
1376             "key": "key",
1377             "value": "value"
1378           }
1379         ],
1380         "edge_order": [
1381           "edge_order"
1382         ],
1383         "position": {
1384           "x": 1.1,
1385           "y": 1.1
1386         },
1387         "transfer_destination": {
1388           "type": "phone",
1389           "phone_number": "phone_number"
1390         },
1391         "transfer_type": "blind",
1392         "post_dial_digits": null
1393       },
1394       "success_transfer": {
1395         "type": "standalone_agent",
1396         "delay_ms": 1,
1397         "edge_order": [
1398           "edge_order"
1399         ],
1400         "enable_transferred_agent_first_message": true,
1401         "position": {
1402           "x": 1.1,
1403           "y": 1.1
1404         },
1405         "preserve_client_tts_overrides": true,
1406         "agent_id": null,
1407         "node_id": null,
1408         "transfer_message": null
1409       },
1410       "tool_node_a": {
1411         "type": "tool",
1412         "edge_order": [
1413           "edge_order"
1414         ],
1415         "position": {
1416           "x": 1.1,
1417           "y": 1.1
1418         },
1419         "tools": [
1420           {
1421             "tool_id": "tool_id"
1422           }
1423         ]
1424       },
1425       "tool_node_b": {
1426         "type": "tool",
1427         "edge_order": [
1428           "edge_order"
1429         ],
1430         "position": {
1431           "x": 1.1,
1432           "y": 1.1
1433         },
1434         "tools": [
1435           {
1436             "tool_id": "tool_id"
1437           }
1438         ]
1439       }
1440     },
1441     "prevent_subagent_loops": false
1442   },
1443   "access_info": {
1444     "is_creator": true,
1445     "creator_name": "John Doe",
1446     "creator_email": "john.doe@example.com",
1447     "role": "admin",
1448     "anonymous_access_level_override": "admin",
1449     "access_source": "creator"
1450   },
1451   "tags": [
1452     "tags"
1453   ],
1454   "version_id": "version_id",
1455   "branch_id": "branch_id",
1456   "main_branch_id": "main_branch_id",
1457   "overridden_fields": [
1458     "overridden_fields"
1459   ],
1460   "source_identical_to_target": true
1461 }

Returns the result of merging the source branch into the target branch without performing the merge. Useful for showing an accurate diff before confirming.

Path parameters

agent_idstringRequired

The id of an agent. This is returned on agent creation.

source_branch_idstringRequired

Unique identifier for the source branch to merge from.

Query parameters

target_branch_idstringRequired

The ID of the target branch to merge into.

forcebooleanOptionalDefaults to false

When true, source branch changes always win conflicts regardless of timestamps

Response

Successful Response

agent_idstring

The ID of the agent

namestring

The name of the agent

conversation_configobject

The conversation configuration of the agent

metadataobject

The metadata of the agent

platform_settingsobject

The platform settings of the agent

phone_numberslist of objects

The phone numbers of the agent

whatsapp_accountslist of objects

WhatsApp accounts assigned to the agent

workflowobject

The workflow of the agent

access_infoobject

The access information of the agent for the user

tagslist of strings

Agent tags used to categorize the agent

version_idstring

The ID of the version the agent is on

branch_idstring

The ID of the branch the agent is on

main_branch_idstring

The ID of the main branch for this agent

overridden_fieldslist of strings

Dot-paths of config fields where both branches modified the same field relative to their common ancestor (conflicts). Present regardless of which side wins the conflict.

source_identical_to_targetbooleanDefaults to false

True when the merge/rebase would be a no-op, i.e. the merged result is identical to the source branch tip. The rebase endpoint rejects in this case.

Errors

422

Merge Preview Request Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors