GET
/v1/convai/test-invocations/{test_invocation_id}
ElevenLabs APIGet Test Invocation
- Base URL
- https://api.elevenlabs.io
- Auth
- xi-api-key: <ELEVENLABS_API_KEY>
- Last verified
- 2026-09-03 · upstream hash matched
Actions
Agents: curl -H "Accept: text/markdown" this URL
→ 167 tokens · Vary: Accept
→ 167 tokens · Vary: Accept
Critical gotchas
Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.
Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.
cURL
curl -X GET 'https://api.elevenlabs.io/v1/convai/test-invocations/test-invocation-id' \ -H "xi-api-key: $ELEVENLABS_API_KEY"Get a free ElevenLabs API key → sponsored
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| test_invocation_id | path | string | Yes | The id of a test invocation. This is returned when tests are run. |
Response 200 OK
{
"id": "string",
"agent_id": "string",
"branch_id": "string",
"created_at": 0,
"folder_id": "string",
"repeat_count": 1,
"bucketing_status": "pending",
"result_groups": [
{
"test_id": "string",
"test_name": "string",
"workflow_node_id": "string",
"buckets": [
{
"test_run_ids": [
"[recursive or deeply nested schema]"
],
"title": "string",
"reason": "string",
"status": "pending"
}
]
}
],
"test_runs": [
{
"test_run_id": "string",
"test_info": {
"from_conversation_metadata": {
"conversation_id": "string",
"agent_id": "string",
"branch_id": "string",
"workflow_node_id": "string",
"original_agent_reply": []
},
"dynamic_variables": {},
"chat_history": [
{
"role": "[recursive or deeply nested schema]",
"agent_metadata": "[recursive or deeply nested schema]",
"message": "[recursive or deeply nested schema]",
"multivoice_message": "[recursive or deeply nested schema]",
"tool_calls": "[recursive or deeply nested schema]",
"tool_results": "[recursive or deeply nested schema]",
"feedback": "[recursive or deeply nested schema]",
"llm_override": "[recursive or deeply nested schema]",
"producing_llm": "[recursive or deeply nested schema]",
"time_in_call_secs": "[recursive or deeply nested schema]",
"conversation_turn_metrics": "[recursive or deeply nested schema]",
"rag_retrieval_info": "[recursive or deeply nested schema]",
"llm_usage": "[recursive or deeply nested schema]",
"interrupted": "[recursive or deeply nested schema]",
"ignored_as_backchannel": "[recursive or deeply nested schema]",
"original_message": "[recursive or deeply nested schema]",
"reasoning": "[recursive or deeply nested schema]",
"source_medium": "[recursive or deeply nested schema]",
"source_event_id": "[recursive or deeply nested schema]",
"used_static_kb_document_ids": "[recursive or deeply nested schema]",
"user_identifier": "[recursive or deeply nested schema]",
"id": "[recursive or deeply nested schema]",
"triggered_guardrails": "[recursive or deeply nested schema]"
}
],
"conversation_initiation_source": "unknown",
"environment": "string",
"type": "llm",
"success_condition": "",
"success_examples": [
{
"response": "[recursive or deeply nested schema]",
"type": "[recursive or deeply nested schema]"
}
],
"failure_examples": [
{
"response": "[recursive or deeply nested schema]",
"type": "[recursive or deeply nested schema]"
}
]
},
"test_invocation_id": "string",
"agent_id": "string",
"branch_id": "string",
"workflow_node_id": "string",
"status": "pending",
"agent_responses": [
{
"role": "user",
"agent_metadata": {
"agent_id": "[recursive or deeply nested schema]",
"branch_id": "[recursive or deeply nested schema]",
"workflow_node_id": "[recursive or deeply nested schema]",
"version_id": "[recursive or deeply nested schema]"
},
"message": "string",
"multivoice_message": {
"parts": "[recursive or deeply nested schema]"
},
"tool_calls": [
"[recursive or deeply nested schema]"
],
"tool_results": [
"[recursive or deeply nested schema]"
],
"feedback": {
"score": "[recursive or deeply nested schema]",
"time_in_call_secs": "[recursive or deeply nested schema]"
},
"llm_override": "string",
"producing_llm": "string",
"time_in_call_secs": 0,
"conversation_turn_metrics": {
"metrics": "[recursive or deeply nested schema]",
"convai_asr_provider": "[recursive or deeply nested schema]",
"convai_tts_model": "[recursive or deeply nested schema]",
"convai_tts_cascade": "[recursive or deeply nested schema]"
},
"rag_retrieval_info": {
"chunks": "[recursive or deeply nested schema]",
"embedding_model": "[recursive or deeply nested schema]",
"retrieval_query": "[recursive or deeply nested schema]",
"rag_latency_secs": "[recursive or deeply nested schema]",
"used_chunk_ids": "[recursive or deeply nested schema]"
},
"llm_usage": {
"model_usage": "[recursive or deeply nested schema]"
},
"interrupted": false,
"ignored_as_backchannel": false,
"original_message": "string",
"reasoning": [
"[recursive or deeply nested schema]"
],
"source_medium": "audio",
"source_event_id": 0,
"used_static_kb_document_ids": [
"[recursive or deeply nested schema]"
],
"user_identifier": "string",
"id": "string",
"triggered_guardrails": [
"[recursive or deeply nested schema]"
]
}
],
"test_id": "string",
"test_name": "Unknown Test",
"condition_result": {
"result": "success",
"rationale": {
"messages": [
"[recursive or deeply nested schema]"
],
"summary": ""
}
},
"last_updated_at_unix": 0,
"metadata": {
"workspace_id": "string",
"test_name": "string",
"ran_by_user_email": "string",
"test_type": "llm"
},
"root_folder_id": "string",
"root_folder_name": "string",
"environment": "string"
}
]
}