For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Connect
BlogHelp CenterAPI PricingSign up
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
OverviewElevenCreativeElevenAgentsElevenAPIReception AIAPI referenceChangelog
  • API reference
    • Introduction
    • Authentication
    • Streaming
  • ElevenAgents
        • POSTRun conversation analysis
      • GETList conversations
      • GETGet conversation details
      • DELDelete conversation
      • GETGet conversation audio
      • GETGet signed URL
      • GETGet conversation token
      • POSTSend conversation feedback
      • POSTUpload conversation file
      • DELDelete conversation file
      • GETGet SIP messages for a conversation
  • ElevenAPI
  • ElevenCreative
  • Core Resources
  • Workspace
  • Legacy
  • Conversational AI
LogoLogo
Login
Login
Connect
BlogHelp CenterAPI PricingSign up
ElevenAgentsConversationsAnalysis

Run conversation analysis

POST
/v1/convai/conversations/:conversation_id/analysis/run
POST
/v1/convai/conversations/:conversation_id/analysis/run
$curl -X POST https://api.elevenlabs.io/v1/convai/conversations/conversation_id/analysis/run
1{
2  "agent_id": "string",
3  "status": "initiated",
4  "metadata": {
5    "start_time_unix_secs": 1,
6    "call_duration_secs": 1,
7    "accepted_time_unix_secs": 1,
8    "cost": 1,
9    "deletion_settings": {
10      "deletion_time_unix_secs": 1,
11      "deleted_logs_at_time_unix_secs": 1,
12      "deleted_audio_at_time_unix_secs": 1,
13      "deleted_transcript_at_time_unix_secs": 1,
14      "delete_transcript_and_pii": false,
15      "delete_audio": false
16    },
17    "feedback": {
18      "type": "thumbs",
19      "overall_score": "like",
20      "likes": 0,
21      "dislikes": 0,
22      "rating": 1,
23      "comment": "string"
24    },
25    "authorization_method": "public",
26    "charging": {
27      "dev_discount": false,
28      "is_burst": false,
29      "tier": "string",
30      "llm_usage": {
31        "irreversible_generation": {
32          "model_usage": {}
33        },
34        "initiated_generation": {
35          "model_usage": {}
36        }
37      },
38      "llm_price": 1.1,
39      "llm_charge": 1,
40      "call_charge": 1,
41      "free_minutes_consumed": 0,
42      "free_llm_dollars_consumed": 0,
43      "tts_usage": {
44        "primary_tts_model": "string",
45        "total_audio_output_seconds": 0,
46        "total_characters": 0,
47        "per_voice_usage": [
48          {
49            "voice_id": "string",
50            "audio_output_seconds": 0
51          }
52        ]
53      },
54      "asr_usage": {
55        "asr_model": "string",
56        "total_transcription_calls": 0,
57        "total_audio_input_seconds": 0
58      }
59    },
60    "phone_call": {
61      "direction": "inbound",
62      "phone_number_id": "string",
63      "agent_number": "string",
64      "external_number": "string",
65      "type": "string",
66      "stream_sid": "string",
67      "call_sid": "string"
68    },
69    "batch_call": {
70      "batch_call_id": "string",
71      "batch_call_recipient_id": "string"
72    },
73    "termination_reason": "",
74    "error": {
75      "code": 1,
76      "reason": "string"
77    },
78    "warnings": [
79      "string"
80    ],
81    "main_language": "string",
82    "rag_usage": {
83      "usage_count": 1,
84      "embedding_model": "string"
85    },
86    "text_only": false,
87    "features_usage": {
88      "language_detection": {
89        "enabled": false,
90        "used": false
91      },
92      "transfer_to_agent": {
93        "enabled": false,
94        "used": false
95      },
96      "transfer_to_number": {
97        "enabled": false,
98        "used": false
99      },
100      "multivoice": {
101        "enabled": false,
102        "used": false
103      },
104      "dtmf_tones": {
105        "enabled": false,
106        "used": false
107      },
108      "external_mcp_servers": {
109        "enabled": false,
110        "used": false
111      },
112      "pii_zrm_workspace": false,
113      "pii_zrm_agent": false,
114      "tool_dynamic_variable_updates": {
115        "enabled": false,
116        "used": false
117      },
118      "is_livekit": false,
119      "voicemail_detection": {
120        "enabled": false,
121        "used": false
122      },
123      "dtmf_input": {
124        "enabled": false,
125        "used": false
126      },
127      "workflow": {
128        "enabled": false,
129        "tool_node": {
130          "enabled": false,
131          "used": false
132        },
133        "standalone_agent_node": {
134          "enabled": false,
135          "used": false
136        },
137        "phone_number_node": {
138          "enabled": false,
139          "used": false
140        },
141        "end_node": {
142          "enabled": false,
143          "used": false
144        }
145      },
146      "agent_testing": {
147        "enabled": false,
148        "tests_ran_after_last_modification": false,
149        "tests_ran_in_last_7_days": false
150      },
151      "versioning": {
152        "enabled": false,
153        "used": false
154      },
155      "file_input": {
156        "enabled": false,
157        "used": false
158      }
159    },
160    "eleven_assistant": {
161      "is_eleven_assistant": false
162    },
163    "initiator_id": "string",
164    "conversation_initiation_source": "unknown",
165    "conversation_initiation_source_version": "string",
166    "timezone": "string",
167    "async_metadata": {
168      "delivery_status": "pending",
169      "delivery_timestamp": 1,
170      "external_system": "string",
171      "external_id": "string",
172      "delivery_error": "string",
173      "external_link": "string",
174      "retry_count": 0,
175      "last_retry_timestamp": 1,
176      "last_processed_external_message_id": "string"
177    },
178    "whatsapp": {
179      "whatsapp_user_id": "string",
180      "direction": "unknown",
181      "whatsapp_phone_number_id": "string",
182      "awaiting_first_user_message": true
183    },
184    "sms": {
185      "direction": "inbound",
186      "sms_user_phone_number": "string",
187      "phone_number_id": "string",
188      "agent_phone_number": "string"
189    },
190    "agent_created_from": "unknown",
191    "agent_last_updated_from": "unknown",
192    "voice_rewards": [
193      {
194        "voice_id": "string",
195        "reward_usd_cents": 1.1
196      }
197    ]
198  },
199  "conversation_id": "string",
200  "has_audio": true,
201  "has_user_audio": true,
202  "has_response_audio": true,
203  "transcript": [
204    {
205      "role": "user",
206      "time_in_call_secs": 1,
207      "agent_metadata": {
208        "agent_id": "string",
209        "branch_id": "string",
210        "workflow_node_id": "string",
211        "version_id": "string"
212      },
213      "message": "string",
214      "multivoice_message": {
215        "parts": [
216          {
217            "text": "string",
218            "voice_label": "string",
219            "time_in_call_secs": 1
220          }
221        ]
222      },
223      "tool_calls": [
224        {
225          "request_id": "string",
226          "tool_name": "string",
227          "params_as_json": "string",
228          "tool_has_been_called": true,
229          "type": "system",
230          "tool_details": {
231            "type": "webhook",
232            "method": "string",
233            "url": "string",
234            "body": "string",
235            "headers": {},
236            "path_params": {},
237            "query_params": {}
238          }
239        }
240      ],
241      "tool_results": [
242        {
243          "request_id": "string",
244          "tool_name": "string",
245          "result_value": "string",
246          "is_error": true,
247          "is_blocked": false,
248          "tool_has_been_called": true,
249          "tool_latency_secs": 0,
250          "error_type": "",
251          "raw_error_message": "",
252          "dynamic_variable_updates": [
253            {
254              "variable_name": "string",
255              "old_value": "string",
256              "new_value": "string",
257              "updated_at": 1.1,
258              "tool_name": "string",
259              "tool_request_id": "string"
260            }
261          ],
262          "type": "client"
263        }
264      ],
265      "feedback": {
266        "score": "like",
267        "time_in_call_secs": 1
268      },
269      "llm_override": "string",
270      "conversation_turn_metrics": {
271        "metrics": {},
272        "convai_asr_provider": "string",
273        "convai_tts_model": "string",
274        "convai_tts_cascade": "string"
275      },
276      "rag_retrieval_info": {
277        "chunks": [
278          {
279            "document_id": "string",
280            "chunk_id": "string",
281            "vector_distance": 1.1
282          }
283        ],
284        "embedding_model": "e5_mistral_7b_instruct",
285        "retrieval_query": "string",
286        "rag_latency_secs": 1.1,
287        "used_chunk_ids": [
288          "string"
289        ]
290      },
291      "llm_usage": {
292        "model_usage": {}
293      },
294      "interrupted": false,
295      "original_message": "string",
296      "source_medium": "audio",
297      "source_event_id": 1,
298      "used_static_kb_document_ids": [
299        "string"
300      ],
301      "file_input": {
302        "file_id": "string",
303        "original_filename": "string",
304        "mime_type": "string",
305        "file_url": "string"
306      },
307      "contextual_update_info": {
308        "context_id": "string",
309        "is_superseded": false
310      }
311    }
312  ],
313  "agent_name": "string",
314  "user_id": "string",
315  "branch_id": "string",
316  "version_id": "string",
317  "analysis": {
318    "call_successful": "success",
319    "transcript_summary": "string",
320    "evaluation_criteria_results": {},
321    "data_collection_results": {},
322    "evaluation_criteria_results_list": [
323      {
324        "criteria_id": "string",
325        "result": "success",
326        "rationale": "string"
327      }
328    ],
329    "data_collection_results_list": [
330      {
331        "data_collection_id": "string",
332        "rationale": "string",
333        "value": null,
334        "json_schema": {
335          "type": "string",
336          "description": "A user-provided message"
337        }
338      }
339    ],
340    "call_summary_title": "string",
341    "scoped": [
342      {
343        "scope": "conversation",
344        "source_agent_id": "string",
345        "successful": "success",
346        "source_branch_id": "string",
347        "evaluation_criteria_results": {},
348        "data_collection_results": {}
349      }
350    ]
351  },
352  "visited_agents": [
353    {
354      "agent_id": "string",
355      "branch_id": "string"
356    }
357  ],
358  "conversation_initiation_client_data": {
359    "conversation_config_override": {
360      "asr": {
361        "keywords": [
362          "hello",
363          "world"
364        ]
365      },
366      "turn": {
367        "soft_timeout_config": {
368          "message": "Hhmmmm...yeah."
369        }
370      },
371      "tts": {
372        "voice_id": "cjVigY5qzO86Huf0OWal",
373        "stability": 0.5,
374        "speed": 1,
375        "similarity_boost": 0.8
376      },
377      "agent": {
378        "first_message": "Hello, how can I help you today?",
379        "language": "en",
380        "prompt": {
381          "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
382          "llm": "gemini-2.0-flash-001",
383          "tool_ids": [],
384          "knowledge_base": []
385        }
386      }
387    },
388    "custom_llm_extra_body": {},
389    "user_id": "string",
390    "source_info": {
391      "source": "unknown",
392      "version": "string"
393    },
394    "branch_id": "string",
395    "environment": "string",
396    "starting_workflow_node_id": "string",
397    "dynamic_variables": {}
398  },
399  "environment": "production",
400  "tag_ids": [
401    "string"
402  ],
403  "otlp_traces": {}
404}
Run the analysis for a conversation using the agent's current evaluation criteria and data collection settings.
Was this page helpful?
Previous

Text search

Next
Built with

Path parameters

conversation_idstringRequired
ID of the conversation

Headers

xi-api-keystringOptional

Response

Successful Response
agent_idstring
statusenum
Allowed values:
metadataobject
conversation_idstring
has_audioboolean
has_user_audioboolean
has_response_audioboolean
transcriptlist of objects
agent_namestring or null
user_idstring or null
branch_idstring or null
version_idstring or null
The ID of the agent version used for this conversation
analysisobject or null
visited_agentslist of objects
conversation_initiation_client_dataobject
environmentstringDefaults to production
tag_idslist of strings
Conversation tag ids assigned to this conversation.
otlp_tracesmap from strings to any or null

OpenTelemetry trace payload when the request uses format=opentelemetry; otherwise omitted.

Errors

422
Unprocessable Entity Error