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_id/branches/source_branch_id/merge-preview \
>      -d target_branch_id=target_branch_id

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       "silence_end_call_timeout": -1,
17       "turn_eagerness": "normal",
18       "spelling_patience": "auto",
19       "speculative_turn": false,
20       "retranscribe_on_turn_timeout": false,
21       "turn_model": "turn_v3",
22       "interruption_ignore_terms": [],
23       "transcribe_on_disabled_interruptions": false,
24       "soft_timeout_config": {
25         "timeout_seconds": -1,
26         "message": "Hhmmmm...yeah."
27       },
28       "mode": "turn"
29     },
30     "tts": {
31       "model_id": "eleven_turbo_v2",
32       "voice_id": "cjVigY5qzO86Huf0OWal",
33       "agent_output_audio_format": "pcm_16000",
34       "optimize_streaming_latency": 3,
35       "stability": 0.5,
36       "speed": 1,
37       "similarity_boost": 0.8,
38       "pronunciation_dictionary_locators": []
39     },
40     "conversation": {
41       "max_duration_seconds": 600,
42       "client_events": [
43         "audio",
44         "interruption"
45       ]
46     },
47     "language_presets": {},
48     "vad": {
49       "background_voice_detection": false
50     },
51     "agent": {
52       "first_message": "Hello, how can I help you today?",
53       "language": "en",
54       "disable_first_message_interruptions": false
55     }
56   },
57   "metadata": {
58     "created_at_unix_secs": 1,
59     "updated_at_unix_secs": 1
60   },
61   "workflow": {
62     "edges": {
63       "entry_to_tool_a": {
64         "source": "entry_node",
65         "target": "tool_node_a",
66         "forward_condition": {
67           "type": "llm",
68           "condition": "Tool A condition"
69         }
70       },
71       "start_to_entry": {
72         "source": "start_node",
73         "target": "entry_node",
74         "forward_condition": {
75           "type": "unconditional"
76         }
77       },
78       "tool_a_to_failure": {
79         "source": "tool_node_a",
80         "target": "failure_node",
81         "forward_condition": {
82           "type": "result",
83           "successful": false
84         }
85       },
86       "tool_a_to_tool_b": {
87         "source": "tool_node_a",
88         "target": "tool_node_b",
89         "forward_condition": {
90           "type": "result",
91           "successful": true
92         }
93       },
94       "tool_b_to_agent_transfer": {
95         "source": "tool_node_b",
96         "target": "success_transfer",
97         "forward_condition": {
98           "type": "unconditional"
99         }
100       },
101       "tool_b_to_conversation": {
102         "source": "tool_node_b",
103         "target": "success_conversation",
104         "forward_condition": {
105           "type": "llm",
106           "condition": "Conversation condition"
107         }
108       },
109       "tool_b_to_end": {
110         "source": "tool_node_b",
111         "target": "success_end",
112         "forward_condition": {
113           "type": "llm",
114           "condition": "End condition"
115         }
116       },
117       "tool_b_to_phone": {
118         "source": "tool_node_b",
119         "target": "success_phone",
120         "forward_condition": {
121           "type": "expression",
122           "expression": {
123             "type": "or_operator",
124             "children": [
125               {
126                 "type": "dynamic_variable",
127                 "name": "force_phone_transfer"
128               },
129               {
130                 "type": "llm",
131                 "value_schema": {
132                   "type": "boolean",
133                   "description": "Phone condition"
134                 },
135                 "prompt": "Phone condition"
136               },
137               {
138                 "type": "eq_operator",
139                 "left": {
140                   "type": "dynamic_variable",
141                   "name": "mode"
142                 },
143                 "right": {
144                   "type": "string_literal",
145                   "value": "dev"
146                 }
147               }
148             ]
149           }
150         }
151       }
152     },
153     "nodes": {
154       "entry_node": {
155         "type": "override_agent",
156         "additional_knowledge_base": [],
157         "additional_prompt": "",
158         "additional_tool_ids": [],
159         "conversation_config": {},
160         "edge_order": [
161           "entry_to_tool_a"
162         ],
163         "entry_behavior": "auto",
164         "label": "Entry",
165         "position": {
166           "x": 0,
167           "y": 0
168         },
169         "auto_advance_after_first_response": false
170       },
171       "failure_node": {
172         "type": "override_agent",
173         "additional_knowledge_base": [],
174         "additional_prompt": "",
175         "additional_tool_ids": [],
176         "conversation_config": {},
177         "edge_order": [],
178         "entry_behavior": "auto",
179         "label": "Failure",
180         "position": {
181           "x": 0,
182           "y": 0
183         },
184         "auto_advance_after_first_response": false
185       },
186       "start_node": {
187         "type": "start",
188         "edge_order": [
189           "start_to_entry"
190         ],
191         "position": {
192           "x": 0,
193           "y": 0
194         }
195       },
196       "success_conversation": {
197         "type": "override_agent",
198         "additional_knowledge_base": [],
199         "additional_prompt": "",
200         "additional_tool_ids": [],
201         "conversation_config": {},
202         "edge_order": [],
203         "entry_behavior": "auto",
204         "label": "Success A",
205         "position": {
206           "x": 0,
207           "y": 0
208         },
209         "auto_advance_after_first_response": false
210       },
211       "success_end": {
212         "type": "end",
213         "edge_order": [],
214         "position": {
215           "x": 0,
216           "y": 0
217         }
218       },
219       "success_phone": {
220         "type": "phone_number",
221         "custom_sip_headers": [],
222         "edge_order": [],
223         "position": {
224           "x": 0,
225           "y": 0
226         },
227         "transfer_destination": {
228           "type": "phone",
229           "phone_number": "+1234567890"
230         },
231         "transfer_type": "conference"
232       },
233       "success_transfer": {
234         "type": "standalone_agent",
235         "agent_id": "success_transfer_agent",
236         "delay_ms": 0,
237         "edge_order": [],
238         "enable_transferred_agent_first_message": false,
239         "position": {
240           "x": 0,
241           "y": 0
242         },
243         "preserve_client_tts_overrides": false
244       },
245       "tool_node_a": {
246         "type": "tool",
247         "edge_order": [
248           "tool_a_to_failure",
249           "tool_a_to_tool_b"
250         ],
251         "position": {
252           "x": 0,
253           "y": 0
254         },
255         "tools": [
256           {
257             "tool_id": "tool_a"
258           },
259           {
260             "tool_id": "tool_b"
261           }
262         ]
263       },
264       "tool_node_b": {
265         "type": "tool",
266         "edge_order": [
267           "tool_b_to_conversation",
268           "tool_b_to_end",
269           "tool_b_to_phone",
270           "tool_b_to_agent_transfer"
271         ],
272         "position": {
273           "x": 0,
274           "y": 0
275         },
276         "tools": [
277           {
278             "tool_id": "tool_a"
279           }
280         ]
281       }
282     },
283     "prevent_subagent_loops": false
284   }
285 }

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 or null

The access information of the agent for the user

tagslist of strings

Agent tags used to categorize the agent

version_idstring or null

The ID of the version the agent is on

branch_idstring or null

The ID of the branch the agent is on

main_branch_idstring or null

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

Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors