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 force=true \
>      -d target_branch_id=agtbrch_8901k4t9z5defmb8vh3e9361y7nj

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

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.

conflictslist of objects

Structured view of the same conflicts as overridden_fields, each carrying the value on the base (common ancestor), source branch, and target branch so the divergence can be presented and resolved field-by-field.

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

Branches Preview Merge Request Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors