---
title: "Get Conversation Details"
method: GET
path: "/v1/convai/conversations/{conversation_id}"
tags: ["Agents Platform"]
---

# Get Conversation Details

`GET /v1/convai/conversations/{conversation_id}`

Get the details of a particular conversation

## Path parameters

- `conversation_id` string, required — The id of the conversation you're taking the action on.

## Query parameters

- `format` 'json' | 'opentelemetry' — Response format. Defaults to 'json'. Set to 'opentelemetry' for an OTLP-compatible trace payload using the same structure as the post-call webhook.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetConversationResponseModel
  - `agent_id` string, required
  - `agent_name` string, nullable
  - `conversation_product` string
  - `status` 'initiated' | 'in-progress' | 'processing' | 'done' | 'failed', required
  - `user_id` string, nullable
  - `branch_id` string, nullable
  - `version_id` string, nullable — The ID of the agent version used for this conversation
  - `metadata` ConversationHistoryMetadataCommonModel, required
    - `start_time_unix_secs` integer, required
    - `accepted_time_unix_secs` integer, nullable
    - `call_duration_secs` integer, required
    - `cost` integer, nullable
    - `deletion_settings` ConversationDeletionSettings
      - `deletion_time_unix_secs` integer, nullable
      - `deleted_logs_at_time_unix_secs` integer, nullable
      - `deleted_audio_at_time_unix_secs` integer, nullable
      - `deleted_transcript_at_time_unix_secs` integer, nullable
      - `delete_transcript_and_pii` boolean
      - `delete_audio` boolean
    - `feedback` ConversationHistoryFeedbackCommonModel
      - `type` 'thumbs' | 'rating'
      - `overall_score` 'like' | 'dislike'
      - `likes` integer
      - `dislikes` integer
      - `rating` integer, nullable
      - `comment` string, nullable
    - `authorization_method` 'invalid' | 'public' | 'authorization_header' | 'signed_url' | 'shareable_link' | 'livekit_token' | 'livekit_token_website' | 'genesys_api_key' | 'audiocodes_api_key' | 'whatsapp' | 'sms'
    - `charging` ConversationChargingCommonModel
      - `dev_discount` boolean
      - `is_burst` boolean
      - `tier` string, nullable
      - `llm_usage` LLMCategoryUsage
        - `irreversible_generation` LLMUsageOutput
          - `model_usage` object
        - `initiated_generation` LLMUsageOutput
          - `model_usage` object
      - `llm_price` number, nullable
      - `llm_charge` integer, nullable
      - `call_charge` integer, nullable
      - `platform_charge` integer, nullable
      - `platform_usage` PlatformUsage — Per-category breakdown of ``platform_charge`` (the analogue of ``llm_usage``).
        - `category_usage` object
      - `platform_price` number, nullable
      - `free_minutes_consumed` number
      - `free_llm_dollars_consumed` number
      - `tts_usage` ConversationTTSUsageModel — Aggregated TTS usage for a conversation (analytics-only, not billing).
        - `primary_tts_model` string, nullable
        - `total_audio_output_seconds` number
        - `total_characters` integer
        - `per_voice_usage` ConversationVoiceUsageModel[]
          - `voice_id` string, required
          - `audio_output_seconds` number
      - `asr_usage` ConversationASRUsageModel — Aggregated ASR usage for a conversation (analytics-only, not billing).
        - `asr_model` string, nullable
        - `total_transcription_calls` integer
        - `total_audio_input_seconds` number
      - `analysis` AnalysisCharging — Cost of running post-call analysis on this conversation. Present once analysis has incurred a cost. `last_run` is null when the most recent pass incurred none.
        - `total` AnalysisRunningTotal, required — Cumulative LLM cost of running post-call analysis on this conversation.
          - `price` number
          - `charge` integer
          - `price_per_feature` object
          - `charge_per_feature` object
        - `last_run` AnalysisRunSnapshot — LLM cost of the most recent post-call analysis pass on this conversation.
          - `price` number
          - `charge` integer
          - `price_per_feature` object
          - `charge_per_feature` object
    - `phone_call` union
      - ConversationHistoryTwilioPhoneCallModel
        - `direction` 'inbound' | 'outbound', required
        - `phone_number_id` string, required
        - `agent_number` string, required
        - `external_number` string, required
        - `type` 'twilio', required
        - `stream_sid` string, required
        - `call_sid` string, required
      - ConversationHistoryExotelPhoneCallModel
        - `direction` 'inbound' | 'outbound', required
        - `phone_number_id` string, required
        - `agent_number` string, required
        - `external_number` string, required
        - `type` 'exotel'
        - `stream_sid` string, required
        - `call_sid` string, required
      - ConversationHistorySIPTrunkingPhoneCallModel
        - `direction` 'inbound' | 'outbound', required
        - `phone_number_id` string, required
        - `agent_number` string, required
        - `external_number` string, required
        - `type` 'sip_trunking', required
        - `call_id` string, nullable
        - `call_sid` string, required
        - `sip_header_dynamic_variables` object
    - `batch_call` ConversationHistoryBatchCallModel
      - `batch_call_id` string, required
      - `batch_call_recipient_id` string, required
    - `termination_reason` string
    - `error` ConversationHistoryErrorCommonModel
      - `code` integer, required
      - `reason` string, nullable
    - `warnings` string[]
    - `main_language` string, nullable
    - `rag_usage` ConversationHistoryRagUsageCommonModel
      - `usage_count` integer, required
      - `embedding_model` string, required
    - `text_only` boolean
    - `features_usage` FeaturesUsageCommonModel
      - `language_detection` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `transfer_to_agent` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `transfer_to_number` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `multivoice` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `dtmf_tones` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `external_mcp_servers` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `pii_zrm_workspace` boolean
      - `pii_zrm_agent` boolean
      - `tool_dynamic_variable_updates` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `is_livekit` boolean
      - `voicemail_detection` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `dtmf_input` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `workflow` WorkflowFeaturesUsageCommonModel
        - `enabled` boolean
        - `tool_node` FeatureStatusCommonModel
          - `enabled` boolean
          - `used` boolean
        - `standalone_agent_node` FeatureStatusCommonModel
          - `enabled` boolean
          - `used` boolean
        - `phone_number_node` FeatureStatusCommonModel
          - `enabled` boolean
          - `used` boolean
        - `end_node` FeatureStatusCommonModel
          - `enabled` boolean
          - `used` boolean
      - `agent_testing` TestsFeatureUsageCommonModel
        - `enabled` boolean
        - `tests_ran_after_last_modification` boolean
        - `tests_ran_in_last_7_days` boolean
      - `versioning` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
      - `file_input` FeatureStatusCommonModel
        - `enabled` boolean
        - `used` boolean
    - `eleven_assistant` ConversationHistoryElevenAssistantCommonModel
      - `is_eleven_assistant` boolean
    - `initiator_id` string, nullable
    - `conversation_initiation_source` 'unknown' | 'android_sdk' | 'node_js_sdk' | 'react_native_sdk' | 'react_sdk' | 'js_sdk' | 'python_sdk' | 'widget' | 'sip_trunk' | 'twilio' | 'exotel' | 'genesys' | 'audiocodes' | 'swift_sdk' | 'whatsapp' | 'twilio_sms' | 'flutter_sdk' | 'zendesk_integration' | 'slack_integration' | 'telegram_integration' | 'intercom_integration' | 'freshdesk_integration' | 'salesforce_integration' | 'template_preview' | 'genesys_bot_connector' | 'subagent_tool' — Enum representing the possible sources for conversation initiation.
    - `conversation_initiation_source_version` string, nullable
    - `timezone` string, nullable
    - `async_metadata` AsyncConversationMetadata — Metadata for async conversation delivery (Zendesk, Slack, etc.).
      - `delivery_status` 'pending' | 'success' | 'failed', required
      - `delivery_timestamp` integer, required
      - `delivery_error` string, nullable
      - `external_system` string, required
      - `external_id` string, required
      - `external_link` string, nullable
      - `retry_count` integer
      - `last_retry_timestamp` integer, nullable
      - `last_processed_external_message_id` string, nullable
    - `whatsapp` WhatsAppConversationInfo
      - `direction` 'inbound' | 'outbound' | 'unknown'
      - `whatsapp_phone_number_id` string, nullable
      - `whatsapp_user_id` string, required
      - `awaiting_first_user_message` boolean, nullable
    - `sms` SMSConversationInfo
      - `direction` 'inbound' | 'outbound', required
      - `phone_number_id` string, nullable
      - `sms_user_phone_number` string, required
      - `agent_phone_number` string, nullable
    - `agent_created_from` 'cli' | 'ui' | 'api' | 'template' | 'unknown'
    - `agent_last_updated_from` 'cli' | 'ui' | 'api' | 'template' | 'unknown'
    - `voice_rewards` ConversationVoiceRewardModel[]
      - `voice_id` string, required
      - `reward_usd_cents` number, required
    - `cost_fiat` number, nullable, required — Total fiat cost of the conversation in USD, i.e. the sum of the LLM price and the non-LLM platform price (the fiat analogue of ``cost``). ``None`` when neither is set (e.g. conversations that predate fiat cost tracking).
  - `analysis` ConversationHistoryAnalysisCommonModel
    - `evaluation_criteria_results` object
    - `data_collection_results` object
    - `evaluation_criteria_results_list` ConversationHistoryEvaluationCriteriaResultCommonModel[]
      - `criteria_id` string, required
      - `result` 'success' | 'failure' | 'unknown', required
      - `rationale` string, required
      - `scoring_mode` 'binary' | 'numeric_uniform'
      - `score` integer, nullable
      - `max_score` integer, nullable
    - `data_collection_results_list` DataCollectionResultCommonModel[]
      - `data_collection_id` string, required
      - `value` unknown
      - `json_schema` LiteralJsonSchemaProperty — Schema property for literal JSON types. IMPORTANT: Only ONE of the following fields can be set: description (LLM provides value), dynamic_variable (value from variable), is_system_provided (system provides value), constant_value (fixed value), or is_omitted (parameter is omitted). These are mutually exclusive.
        - `type` union, required
          - 'boolean' | 'string' | 'integer' | 'number'
          - string[]
        - `description` string — The description of the property. When set, the LLM will provide the value based on this description. Mutually exclusive with dynamic_variable, is_system_provided, constant_value, and is_omitted.
        - `enum` string[], nullable — List of allowed string values for string type parameters
        - `is_system_provided` boolean — If true, the value will be populated by the system at runtime. Used by API Integration Webhook tools for templating. Mutually exclusive with description, dynamic_variable, constant_value, and is_omitted.
        - `dynamic_variable` string — The name of the dynamic variable to use for this property's value. Mutually exclusive with description, is_system_provided, constant_value, and is_omitted.
        - `allowed_values_dynamic_variable` string — When set, the LLM provides the value but the runtime rejects any value not present in the list held by this dynamic variable. Use to let the LLM pick from a server-verified set (e.g. the IDs the current user is allowed to access). Requires description; mutually exclusive with dynamic_variable, is_system_provided, constant_value, and is_omitted.
        - `constant_value` union — A constant value to use for this property. Mutually exclusive with description, dynamic_variable, is_system_provided, and is_omitted.
          - string
          - integer
          - number
          - boolean
        - `is_omitted` boolean — If true, this parameter will be completely omitted from the request. Only valid for optional parameters. Mutually exclusive with description, dynamic_variable, is_system_provided, and constant_value.
      - `rationale` string, required
    - `call_successful` 'success' | 'failure' | 'unknown', required
    - `call_success_score` number, nullable
    - `transcript_summary` string, required
    - `call_summary_title` string, nullable
    - `scoped` ScopedAnalysisResult[]
      - `scope` 'conversation' | 'agent', required
      - `source_agent_id` string, required
      - `source_branch_id` string, nullable — Branch of the agent for this scoped block; disambiguates repeated agent_id.
      - `evaluation_criteria_results` object
      - `data_collection_results` object
      - `successful` 'success' | 'failure' | 'unknown', required
      - `success_score` number, nullable
  - `visited_agents` VisitedAgentRef[]
    - `agent_id` string, required
    - `branch_id` string, nullable
  - `conversation_initiation_client_data` ConversationInitiationClientDataRequestOutput
    - `conversation_config_override` ConversationConfigClientOverrideOutput
      - `asr` ASRConversationalConfigOverride
        - `keywords` string[], nullable — Keywords to boost prediction probability for
      - `turn` TurnConfigOverride
        - `soft_timeout_config` SoftTimeoutConfigOverride
          - `message` string, nullable — Message to show when the first soft timeout is reached while waiting for LLM response. Supports dynamic variables (e.g., {{system__time}}, {{custom_variable}}).
      - `tts` TTSConversationalConfigOverride
        - `model_id` 'eleven_turbo_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3_conversational', nullable — The model to use for TTS
        - `voice_id` string, nullable — The voice ID to use for TTS
        - `stability` number, nullable — The stability of generated speech
        - `speed` number, nullable — The speed of generated speech
        - `similarity_boost` number, nullable — The similarity boost for generated speech
      - `conversation` ConversationConfigOverride
        - `text_only` boolean, nullable — If enabled audio will not be processed and only text will be used, use to avoid audio pricing.
      - `agent` AgentConfigOverrideOutput
        - `first_message` string, nullable — If non-empty, the first message the agent will say. If empty, the agent waits for the user to start the discussion.
        - `language` string, nullable — Language of the agent - used for ASR and TTS
        - `max_conversation_duration_message` string, nullable — If non-empty, the message the agent will send when max conversation duration is reached.
        - `prompt` PromptAgentAPIModelOverrideOutput
          - `prompt` string, nullable — The prompt for the agent
          - `llm` 'gpt-4o-mini' | 'gpt-4o' | 'gpt-4' | 'gpt-4-turbo' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.2-chat-latest' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.5' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-3.5-turbo' | 'gemini-1.5-pro' | 'gemini-1.5-flash' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash' | 'gemini-3-pro-preview' | 'gemini-3-flash-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-lite-preview' | 'gemini-3.1-flash-lite' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'claude-sonnet-4-5' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'claude-sonnet-4' | 'claude-haiku-4-5' | 'claude-3-7-sonnet' | 'claude-3-5-sonnet' | 'claude-3-5-sonnet-v1' | 'claude-3-haiku' | 'grok-beta' | 'custom-llm' | 'qwen3-4b' | 'qwen3-30b-a3b' | 'qwen36-35b-a3b' | 'qwen35-397b-a17b' | 'gpt-oss-20b' | 'gpt-oss-120b' | 'glm-45-air-fp8' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-preview-05-20' | 'gemini-2.5-flash-preview-04-17' | 'gemini-2.5-flash-lite-preview-06-17' | 'gemini-2.0-flash-lite-001' | 'gemini-2.0-flash-001' | 'gemini-1.5-flash-002' | 'gemini-1.5-flash-001' | 'gemini-1.5-pro-002' | 'gemini-1.5-pro-001' | 'claude-sonnet-4@20250514' | 'claude-sonnet-4-5@20250929' | 'claude-haiku-4-5@20251001' | 'claude-3-7-sonnet@20250219' | 'claude-3-5-sonnet@20240620' | 'claude-3-5-sonnet-v2@20241022' | 'claude-3-haiku@20240307' | 'gpt-5-2025-08-07' | 'gpt-5.1-2025-11-13' | 'gpt-5.2-2025-12-11' | 'gpt-5.4-2026-03-05' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.5-2026-04-23' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'gpt-4o-mini-2024-07-18' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4-0613' | 'gpt-4-0314' | 'gpt-4-turbo-2024-04-09' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-1106' | 'watt-tool-8b' | 'watt-tool-70b', nullable — The LLM to query with the prompt and the chat history. If using data residency, the LLM must be supported in the data residency environment
          - `tool_ids` string[], nullable — A list of IDs of tools used by the agent
          - `native_mcp_server_ids` string[], nullable — A list of Native MCP server ids to be used by the agent
          - `knowledge_base` KnowledgeBaseLocator[], nullable — A list of knowledge bases to be used by the agent
            - `type` 'file' | 'url' | 'text' | 'folder', required
            - `name` string, required — The name of the knowledge base
            - `id` string, required — The ID of the knowledge base
            - `usage_mode` 'prompt' | 'auto'
    - `custom_llm_extra_body` object
    - `user_id` string, nullable — ID of the end user participating in this conversation (for agent owner's user identification)
    - `source_info` ConversationInitiationSourceInfo — Information about the source of conversation initiation
      - `source` 'unknown' | 'android_sdk' | 'node_js_sdk' | 'react_native_sdk' | 'react_sdk' | 'js_sdk' | 'python_sdk' | 'widget' | 'sip_trunk' | 'twilio' | 'exotel' | 'genesys' | 'audiocodes' | 'swift_sdk' | 'whatsapp' | 'twilio_sms' | 'flutter_sdk' | 'zendesk_integration' | 'slack_integration' | 'telegram_integration' | 'intercom_integration' | 'freshdesk_integration' | 'salesforce_integration' | 'template_preview' | 'genesys_bot_connector' | 'subagent_tool' — Enum representing the possible sources for conversation initiation.
      - `version` string, nullable — The SDK version number
    - `branch_id` string, nullable — ID of the agent branch to use for this conversation
    - `environment` string, nullable — Environment to use for resolving environment variables
    - `starting_workflow_node_id` string, nullable — If set, start the workflow at this node id instead of the default entry
    - `dynamic_variables` object
  - `environment` string
  - `conversation_id` string, required
  - `has_audio` boolean, required
  - `has_user_audio` boolean, required
  - `has_response_audio` boolean, required
  - `has_auxiliary_audio` boolean, required
  - `transcript` ConversationHistoryTranscriptResponseModel[], required
    - `role` 'user' | 'agent', required
    - `agent_metadata` AgentMetadata
      - `agent_id` string, required
      - `branch_id` string, nullable
      - `workflow_node_id` string, nullable
      - `version_id` string, nullable
    - `message` string, nullable
    - `multivoice_message` ConversationHistoryMultivoiceMessageModel — Represents a message from a multi-voice agent.
      - `parts` ConversationHistoryMultivoiceMessagePartModel[], required
        - `text` string, required
        - `voice_label` string, nullable, required
        - `time_in_call_secs` integer, nullable, required
    - `tool_calls` ConversationHistoryTranscriptToolCallCommonModelOutput[]
      - `type` 'system' | 'webhook' | 'client' | 'mcp' | 'workflow' | 'api_integration_webhook' | 'api_integration_mcp' | 'smb'
      - `request_id` string, required
      - `tool_name` string, required
      - `params_as_json` string, required
      - `tool_has_been_called` boolean, required
      - `tool_details` union
        - ConversationHistoryTranscriptToolCallWebhookDetails
          - `type` 'webhook'
          - `method` string, required
          - `url` string, required
          - `headers` object
          - `path_params` object
          - `query_params` object
          - `body` string, nullable
        - ConversationHistoryTranscriptToolCallClientDetails
          - `type` 'client'
          - `parameters` string, required
        - ConversationHistoryTranscriptToolCallMCPDetails
          - `type` 'mcp'
          - `mcp_server_id` string, required
          - `mcp_server_name` string, required
          - `integration_type` string, required
          - `parameters` object
          - `approval_policy` string, required
          - `requires_approval` boolean
          - `mcp_tool_name` string
          - `mcp_tool_description` string
        - ConversationHistoryTranscriptToolCallApiIntegrationWebhookDetailsOutput
          - `type` 'api_integration_webhook', required
          - `integration_id` string, required
          - `credential_id` string, required
          - `integration_connection_id` string, required
          - `webhook_details` ConversationHistoryTranscriptToolCallWebhookDetails, required
            - `type` 'webhook'
            - `method` string, required
            - `url` string, required
            - `headers` object
            - `path_params` object
            - `query_params` object
            - `body` string, nullable
    - `tool_results` union[]
      - union
        - ConversationHistoryTranscriptOtherToolsResultCommonModel
          - `request_id` string, required
          - `tool_name` string, required
          - `result_value` string, required
          - `is_error` boolean, required
          - `is_blocked` boolean
          - `tool_has_been_called` boolean, required
          - `tool_latency_secs` number
          - `error_type` string
          - `raw_error_message` string
          - `dynamic_variable_updates` DynamicVariableUpdateCommonModel[]
            - `variable_name` string, required
            - `old_value` string, nullable, required
            - `new_value` string, required
            - `updated_at` number, required
            - `tool_name` string, required
            - `tool_request_id` string, required
          - `type` 'client' | 'webhook' | 'mcp' | 'code', nullable
        - ConversationHistoryTranscriptSystemToolResultCommonModelOutput
          - `request_id` string, required
          - `tool_name` string, required
          - `result_value` string, required
          - `is_error` boolean, required
          - `is_blocked` boolean
          - `tool_has_been_called` boolean, required
          - `tool_latency_secs` number
          - `error_type` string
          - `raw_error_message` string
          - `dynamic_variable_updates` DynamicVariableUpdateCommonModel[]
            - `variable_name` string, required
            - `old_value` string, nullable, required
            - `new_value` string, required
            - `updated_at` number, required
            - `tool_name` string, required
            - `tool_request_id` string, required
          - `type` 'system', required
          - `result` union
            - EndCallToolResultModel
              - …
            - LanguageDetectionToolResultModel
              - …
            - TransferToAgentToolResultSuccessModelOutput
              - …
            - TransferToAgentToolResultErrorModel
              - …
            - TransferToNumberResultTwilioSuccessModel
              - …
            - TransferToNumberResultSipSuccessModel
              - …
            - TransferToNumberResultExotelSuccessModel
              - …
            - TransferToNumberResultErrorModel
              - …
            - SkipTurnToolResponseModel
              - …
            - PlayDTMFResultSuccessModel
              - …
            - PlayDTMFResultErrorModel
              - …
            - VoiceMailDetectionResultSuccessModel
              - …
            - TestToolResultModel
              - …
            - KnowledgeBaseRagToolResultModel
              - …
            - KnowledgeBaseToolResultModel
              - …
            - DummyToolResultModel
              - …
        - ConversationHistoryTranscriptApiIntegrationWebhookToolsResultCommonModelOutput
          - `request_id` string, required
          - `tool_name` string, required
          - `result_value` string, required
          - `is_error` boolean, required
          - `is_blocked` boolean, required
          - `tool_has_been_called` boolean, required
          - `tool_latency_secs` number, required
          - `error_type` string, required
          - `raw_error_message` string, required
          - `dynamic_variable_updates` DynamicVariableUpdateCommonModel[], required
            - `variable_name` string, required
            - `old_value` string, nullable, required
            - `new_value` string, required
            - `updated_at` number, required
            - `tool_name` string, required
            - `tool_request_id` string, required
          - `type` 'api_integration_webhook', required
          - `integration_id` string, required
          - `credential_id` string, required
          - `integration_connection_id` string, required
        - ConversationHistoryTranscriptWorkflowToolsResultCommonModelOutput
          - `request_id` string, required
          - `tool_name` string, required
          - `result_value` string, required
          - `is_error` boolean, required
          - `is_blocked` boolean
          - `tool_has_been_called` boolean, required
          - `tool_latency_secs` number
          - `error_type` string
          - `raw_error_message` string
          - `dynamic_variable_updates` DynamicVariableUpdateCommonModel[]
            - `variable_name` string, required
            - `old_value` string, nullable, required
            - `new_value` string, required
            - `updated_at` number, required
            - `tool_name` string, required
            - `tool_request_id` string, required
          - `type` 'workflow', required
          - `result` WorkflowToolResponseModelOutput — A common model for workflow tool responses.
            - `steps` union[]
              - …
    - `feedback` UserFeedback
      - `score` 'like' | 'dislike', required
      - `time_in_call_secs` integer, required
    - `llm_override` string, nullable
    - `time_in_call_secs` integer, required
    - `conversation_turn_metrics` ConversationTurnMetrics
      - `metrics` object
      - `convai_asr_provider` string, nullable
      - `convai_tts_model` string, nullable
      - `convai_tts_cascade` string, nullable
    - `rag_retrieval_info` RagRetrievalInfo
      - `chunks` RagChunkMetadata[], required
        - `document_id` string, required
        - `chunk_id` string, required
        - `vector_distance` number, required
      - `embedding_model` 'e5_mistral_7b_instruct' | 'multilingual_e5_large_instruct', required
      - `retrieval_query` string, required
      - `rag_latency_secs` number, required
      - `used_chunk_ids` string[]
    - `llm_usage` LLMUsageOutput
      - `model_usage` object
    - `interrupted` boolean
    - `ignored_as_backchannel` boolean
    - `original_message` string, nullable
    - `reasoning` ConversationReasoningModel[]
      - `summary` string, nullable
      - `provider_redact` boolean
    - `source_medium` 'audio' | 'text' | 'image' | 'file'
    - `source_event_id` integer, nullable
    - `used_static_kb_document_ids` string[]
    - `user_identifier` string, nullable
    - `id` string, nullable
    - `triggered_guardrails` TriggeredGuardrailCommonModel[]
      - `guardrail_type` 'custom' | 'prompt_injection' | 'self_harm_intent' | 'violence_graphic' | 'sexual' | 'violence' | 'harassment' | 'sexual_minors' | 'self_harm' | 'self_harm_instructions' | 'harassment_threatening' | 'hate' | 'hate_threatening' | 'profanity' | 'religion_or_politics' | 'medical_and_legal' | 'guardrail', required
      - `guardrail_name` string, nullable
    - `file_input` ConversationHistoryTranscriptFileInputResponseModel
      - `file_id` string, required
      - `original_filename` string, required
      - `mime_type` string, required
      - `file_url` string, required
    - `contextual_update_info` ContextualUpdateInfo
      - `context_id` string, required — Client-supplied identifier grouping related contextual updates.
      - `is_superseded` boolean — True when this contextual update has been replaced by a newer update with the same context_id.
    - `reasoned` boolean
  - `tag_ids` string[] — Conversation tag ids assigned to this conversation.
  - `otlp_traces` object, nullable — OpenTelemetry trace payload when the request uses format=opentelemetry; otherwise omitted.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/57d56f34628a/schema)