Get test invocation

GET

/v1/convai/test-invocations/:test_invocation_id

GET

/v1/convai/test-invocations/:test_invocation_id

$ curl https://api.elevenlabs.io/v1/convai/test-invocations/test_invocation_id

1 {
2   "id": "string",
3   "test_runs": [
4     {
5       "test_run_id": "string",
6       "test_invocation_id": "string",
7       "agent_id": "string",
8       "status": "pending",
9       "test_id": "string",
10       "test_info": {
11         "type": "llm",
12         "chat_history": [
13           {
14             "role": "user",
15             "time_in_call_secs": 1,
16             "agent_metadata": {
17               "agent_id": "string",
18               "branch_id": "string",
19               "workflow_node_id": "string",
20               "version_id": "string"
21             },
22             "message": "string",
23             "multivoice_message": {
24               "parts": [
25                 {
26                   "text": "string",
27                   "voice_label": "string",
28                   "time_in_call_secs": 1
29                 }
30               ]
31             },
32             "tool_calls": [
33               {
34                 "request_id": "string",
35                 "tool_name": "string",
36                 "params_as_json": "string",
37                 "tool_has_been_called": true,
38                 "type": "system",
39                 "tool_details": {
40                   "type": "webhook",
41                   "method": "string",
42                   "url": "string",
43                   "body": "string",
44                   "headers": {},
45                   "path_params": {},
46                   "query_params": {}
47                 }
48               }
49             ],
50             "tool_results": [
51               {
52                 "dynamic_variable_updates": [
53                   {
54                     "new_value": "string",
55                     "old_value": "string",
56                     "tool_name": "string",
57                     "tool_request_id": "string",
58                     "updated_at": 1.1,
59                     "variable_name": "string"
60                   }
61                 ],
62                 "error_type": "",
63                 "is_blocked": false,
64                 "is_error": true,
65                 "raw_error_message": "",
66                 "request_id": "string",
67                 "result_value": "string",
68                 "tool_has_been_called": true,
69                 "tool_latency_secs": 0,
70                 "tool_name": "string",
71                 "type": "client"
72               }
73             ],
74             "feedback": {
75               "score": "like",
76               "time_in_call_secs": 1
77             },
78             "llm_override": "string",
79             "producing_llm": "string",
80             "conversation_turn_metrics": {
81               "metrics": {},
82               "convai_asr_provider": "string",
83               "convai_tts_model": "string",
84               "convai_tts_cascade": "string"
85             },
86             "rag_retrieval_info": {
87               "chunks": [
88                 {
89                   "document_id": "string",
90                   "chunk_id": "string",
91                   "vector_distance": 1.1
92                 }
93               ],
94               "embedding_model": "e5_mistral_7b_instruct",
95               "retrieval_query": "string",
96               "rag_latency_secs": 1.1,
97               "used_chunk_ids": [
98                 "string"
99               ]
100             },
101             "llm_usage": {
102               "model_usage": {}
103             },
104             "interrupted": false,
105             "ignored_as_backchannel": false,
106             "original_message": "string",
107             "reasoning": [
108               {
109                 "summary": "string",
110                 "provider_redact": false
111               }
112             ],
113             "source_medium": "audio",
114             "source_event_id": 1,
115             "used_static_kb_document_ids": [
116               "string"
117             ],
118             "user_identifier": "string",
119             "id": "string",
120             "triggered_guardrails": [
121               {
122                 "guardrail_type": "custom",
123                 "guardrail_name": "string"
124               }
125             ]
126           }
127         ],
128         "conversation_initiation_source": "unknown",
129         "dynamic_variables": {},
130         "failure_examples": [
131           {
132             "response": "string",
133             "type": "string"
134           }
135         ],
136         "from_conversation_metadata": {
137           "conversation_id": "string",
138           "agent_id": "string",
139           "branch_id": "string",
140           "workflow_node_id": "string",
141           "original_agent_reply": [
142             {
143               "role": "user",
144               "time_in_call_secs": 1,
145               "agent_metadata": {
146                 "agent_id": "string",
147                 "branch_id": "string",
148                 "workflow_node_id": "string",
149                 "version_id": "string"
150               },
151               "message": "string",
152               "multivoice_message": {
153                 "parts": [
154                   {
155                     "text": "string",
156                     "voice_label": "string",
157                     "time_in_call_secs": 1
158                   }
159                 ]
160               },
161               "tool_calls": [
162                 {
163                   "request_id": "string",
164                   "tool_name": "string",
165                   "params_as_json": "string",
166                   "tool_has_been_called": true,
167                   "type": "system",
168                   "tool_details": {
169                     "type": "api_integration_webhook",
170                     "credential_id": "",
171                     "integration_connection_id": "",
172                     "integration_id": "",
173                     "webhook_details": {
174                       "method": {},
175                       "url": {},
176                       "headers": {},
177                       "path_params": {},
178                       "query_params": {},
179                       "body": {},
180                       "type": {}
181                     }
182                   }
183                 }
184               ],
185               "tool_results": [
186                 {
187                   "dynamic_variable_updates": [
188                     {
189                       "new_value": "string",
190                       "old_value": "string",
191                       "tool_name": "string",
192                       "tool_request_id": "string",
193                       "updated_at": 1.1,
194                       "variable_name": "string"
195                     }
196                   ],
197                   "error_type": "",
198                   "is_blocked": false,
199                   "is_error": true,
200                   "raw_error_message": "",
201                   "request_id": "string",
202                   "result_value": "string",
203                   "tool_has_been_called": true,
204                   "tool_latency_secs": 0,
205                   "tool_name": "string",
206                   "type": "client"
207                 }
208               ],
209               "feedback": {
210                 "score": "like",
211                 "time_in_call_secs": 1
212               },
213               "llm_override": "string",
214               "producing_llm": "string",
215               "conversation_turn_metrics": {
216                 "metrics": {},
217                 "convai_asr_provider": "string",
218                 "convai_tts_model": "string",
219                 "convai_tts_cascade": "string"
220               },
221               "rag_retrieval_info": {
222                 "chunks": [
223                   {
224                     "document_id": "string",
225                     "chunk_id": "string",
226                     "vector_distance": 1.1
227                   }
228                 ],
229                 "embedding_model": "e5_mistral_7b_instruct",
230                 "retrieval_query": "string",
231                 "rag_latency_secs": 1.1,
232                 "used_chunk_ids": [
233                   "string"
234                 ]
235               },
236               "llm_usage": {
237                 "model_usage": {}
238               },
239               "interrupted": false,
240               "ignored_as_backchannel": false,
241               "original_message": "string",
242               "reasoning": [
243                 {
244                   "summary": "string",
245                   "provider_redact": false
246                 }
247               ],
248               "source_medium": "audio",
249               "source_event_id": 1,
250               "used_static_kb_document_ids": [
251                 "string"
252               ],
253               "user_identifier": "string",
254               "id": "string",
255               "triggered_guardrails": [
256                 {
257                   "guardrail_type": "custom",
258                   "guardrail_name": "string"
259                 }
260               ]
261             }
262           ]
263         },
264         "success_condition": "",
265         "success_examples": [
266           {
267             "response": "string",
268             "type": "string"
269           }
270         ]
271       },
272       "branch_id": "string",
273       "workflow_node_id": "string",
274       "agent_responses": [
275         {
276           "role": "user",
277           "time_in_call_secs": 1,
278           "agent_metadata": {
279             "agent_id": "string",
280             "branch_id": "string",
281             "workflow_node_id": "string",
282             "version_id": "string"
283           },
284           "message": "string",
285           "multivoice_message": {
286             "parts": [
287               {
288                 "text": "string",
289                 "voice_label": "string",
290                 "time_in_call_secs": 1
291               }
292             ]
293           },
294           "tool_calls": [
295             {
296               "request_id": "string",
297               "tool_name": "string",
298               "params_as_json": "string",
299               "tool_has_been_called": true,
300               "type": "system",
301               "tool_details": {
302                 "type": "webhook",
303                 "method": "string",
304                 "url": "string",
305                 "body": "string",
306                 "headers": {},
307                 "path_params": {},
308                 "query_params": {}
309               }
310             }
311           ],
312           "tool_results": [
313             {
314               "dynamic_variable_updates": [
315                 {
316                   "new_value": "string",
317                   "old_value": "string",
318                   "tool_name": "string",
319                   "tool_request_id": "string",
320                   "updated_at": 1.1,
321                   "variable_name": "string"
322                 }
323               ],
324               "error_type": "",
325               "is_blocked": false,
326               "is_error": true,
327               "raw_error_message": "",
328               "request_id": "string",
329               "result_value": "string",
330               "tool_has_been_called": true,
331               "tool_latency_secs": 0,
332               "tool_name": "string",
333               "type": "client"
334             }
335           ],
336           "feedback": {
337             "score": "like",
338             "time_in_call_secs": 1
339           },
340           "llm_override": "string",
341           "producing_llm": "string",
342           "conversation_turn_metrics": {
343             "metrics": {},
344             "convai_asr_provider": "string",
345             "convai_tts_model": "string",
346             "convai_tts_cascade": "string"
347           },
348           "rag_retrieval_info": {
349             "chunks": [
350               {
351                 "document_id": "string",
352                 "chunk_id": "string",
353                 "vector_distance": 1.1
354               }
355             ],
356             "embedding_model": "e5_mistral_7b_instruct",
357             "retrieval_query": "string",
358             "rag_latency_secs": 1.1,
359             "used_chunk_ids": [
360               "string"
361             ]
362           },
363           "llm_usage": {
364             "model_usage": {}
365           },
366           "interrupted": false,
367           "ignored_as_backchannel": false,
368           "original_message": "string",
369           "reasoning": [
370             {
371               "summary": "string",
372               "provider_redact": false
373             }
374           ],
375           "source_medium": "audio",
376           "source_event_id": 1,
377           "used_static_kb_document_ids": [
378             "string"
379           ],
380           "user_identifier": "string",
381           "id": "string",
382           "triggered_guardrails": [
383             {
384               "guardrail_type": "custom",
385               "guardrail_name": "string"
386             }
387           ]
388         }
389       ],
390       "test_name": "Unknown Test",
391       "condition_result": {
392         "result": "success",
393         "rationale": {
394           "messages": [
395             "string"
396           ],
397           "summary": ""
398         }
399       },
400       "last_updated_at_unix": 1,
401       "metadata": {
402         "workspace_id": "string",
403         "test_name": "string",
404         "ran_by_user_email": "string",
405         "test_type": "llm"
406       },
407       "root_folder_id": "string",
408       "root_folder_name": "string",
409       "environment": "string"
410     }
411   ],
412   "agent_id": "string",
413   "branch_id": "string",
414   "created_at": 1,
415   "folder_id": "string",
416   "repeat_count": 1,
417   "bucketing_status": "pending",
418   "result_groups": [
419     {
420       "test_id": "string",
421       "test_name": "string",
422       "buckets": [
423         {
424           "test_run_ids": [
425             "string"
426           ],
427           "title": "string",
428           "reason": "string",
429           "status": "pending"
430         }
431       ],
432       "workflow_node_id": "string"
433     }
434   ]
435 }

Gets a test invocation by ID.

Path parameters

test_invocation_idstringRequired

The id of a test invocation. This is returned when tests are run.

Response

Successful Response

idstring

test_runslist of objects

agent_idstring or nullOptional

branch_idstring or nullOptional

created_atintegerOptional

folder_idstring or nullOptional

repeat_countintegerOptionalDefaults to 1

bucketing_statusenum or nullOptional

None when repeat_count==1 (no bucketing). Otherwise tracks bucketing lifecycle.

result_groupslist of objectsOptional

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Response

Errors