retell-sdk 5.22.0 → 5.24.0

package/resources/call.d.mts

@@ -32,11 +32,14 @@ export declare class Call extends APIResource {
      */
     update(callID: string, body: CallUpdateParams, options?: RequestOptions): APIPromise<CallResponse>;
     /**
-     * Retrieve call details
+     * List calls with unified cursor pagination response.
      *
-     * @deprecated
+     * @example
+     * ```ts
+     * const calls = await client.call.list();
+     * ```
      */
-    list(body: CallListParams, options?: RequestOptions): APIPromise<CallListResponse>;
+    list(body?: CallListParams | null | undefined, options?: RequestOptions): APIPromise<CallListResponse>;
     /**
      * Delete a specific call and its associated data
      *
@@ -1826,171 +1829,1802 @@ export declare namespace WebCallResponse {
         role: 'dtmf';
     }
 }
-export type CallListResponse = Array<CallResponse>;
-export interface CallUpdateParams {
-    /**
-     * Custom attributes for the call
-     */
-    custom_attributes?: {
-        [key: string]: string | number | boolean;
-    };
-    /**
-     * Data storage setting for this call. Overrides the agent's default setting.
-     * "everything" stores all data, "everything_except_pii" excludes PII when
-     * possible, "basic_attributes_only" stores only metadata. Cannot be downgraded
-     * from more restrictive to less restrictive settings.
-     */
-    data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only';
-    /**
-     * An arbitrary object for storage purpose only. You can put anything here like
-     * your internal customer id associated with the call. Not used for processing. You
-     * can later get this field from the call object. Size limited to 50kB max.
-     */
-    metadata?: unknown;
-    /**
-     * Override dynamic varaibles represented as key-value pairs of strings. Setting
-     * this will override or add the dynamic variables set in the agent during the
-     * call. Only need to set the delta where you want to override, no need to set the
-     * entire dynamic variables object. Setting this to null will remove any existing
-     * override.
-     */
-    override_dynamic_variables?: {
-        [key: string]: string;
-    } | null;
-}
-export interface CallListParams {
-    /**
-     * Filter criteria for the calls to retrieve.
-     */
-    filter_criteria?: CallListParams.FilterCriteria;
+export interface CallListResponse {
     /**
-     * Limit the number of calls returned. Default 50, Max 1000. To retrieve more than
-     * 1000, use pagination_key to continue fetching the next page.
+     * Whether more results are available.
      */
-    limit?: number;
+    has_more?: boolean;
+    items?: Array<CallListResponse.V3WebCallResponse | CallListResponse.V3PhoneCallResponse>;
     /**
-     * The pagination key to continue fetching the next page of calls. Pagination key
-     * is represented by a call id here, and it's exclusive (not included in the
-     * fetched calls). The last call id from the list calls is usually used as
-     * pagination key here. If not set, will start from the beginning.
+     * Pagination key for the next page.
      */
     pagination_key?: string;
-    /**
-     * The calls will be sorted by `start_timestamp`, whether to return the calls in
-     * ascending or descending order.
-     */
-    sort_order?: 'ascending' | 'descending';
 }
-export declare namespace CallListParams {
-    /**
-     * Filter criteria for the calls to retrieve.
-     */
-    interface FilterCriteria {
+export declare namespace CallListResponse {
+    interface V3WebCallResponse {
+        /**
+         * Access token to enter the web call room. This needs to be passed to your
+         * frontend to join the call.
+         */
+        access_token: string;
         /**
-         * Only retrieve calls that are made with specific agent(s).
+         * Corresponding agent id of this call.
          */
-        agent_id?: Array<string>;
+        agent_id: string;
         /**
-         * Only retrieve calls with specific batch call id(s).
+         * The version of the agent.
          */
-        batch_call_id?: Array<string>;
+        agent_version: number;
         /**
-         * Only retrieve calls with specific call id(s).
+         * Unique id of the call. Used to identify the call in the LLM websocket and used
+         * to authenticate in the audio websocket.
          */
-        call_id?: Array<string>;
+        call_id: string;
         /**
-         * Only retrieve calls with specific call status(es).
+         * Status of call.
+         *
+         * - `registered`: Call id issued, starting to make a call using this id.
+         * - `ongoing`: Call connected and ongoing.
+         * - `ended`: The underlying websocket has ended for the call. Either user or agent
+         *   hung up, or call transferred.
+         * - `error`: Call encountered error.
          */
-        call_status?: Array<'not_connected' | 'ongoing' | 'ended' | 'error'>;
+        call_status: 'registered' | 'not_connected' | 'ongoing' | 'ended' | 'error';
         /**
-         * Only retrieve calls with specific call successful(s).
+         * Type of the call. Used to distinguish between web call and phone call.
          */
-        call_successful?: Array<boolean>;
+        call_type: 'web_call';
         /**
-         * Only retrieve calls with specific call type(s).
+         * Name of the agent.
          */
-        call_type?: Array<'web_call' | 'phone_call'>;
+        agent_name?: string;
         /**
-         * Only retrieve calls with specific direction(s).
+         * Post call analysis that includes information such as sentiment, status, summary,
+         * and custom defined data to extract. Available after call ends. Subscribe to
+         * `call_analyzed` webhook event type to receive it once ready.
          */
-        direction?: Array<'inbound' | 'outbound'>;
+        call_analysis?: V3WebCallResponse.CallAnalysis;
         /**
-         * Only retrieve calls with specific disconnection reason(s).
+         * Cost of the call, including all the products and their costs and discount.
          */
-        disconnection_reason?: Array<'user_hangup' | 'agent_hangup' | 'call_transfer' | 'voicemail_reached' | 'ivr_reached' | 'inactivity' | 'max_duration_reached' | 'concurrency_limit_reached' | 'no_valid_payment' | 'scam_detected' | 'dial_busy' | 'dial_failed' | 'dial_no_answer' | 'invalid_destination' | 'telephony_provider_permission_denied' | 'telephony_provider_unavailable' | 'sip_routing_error' | 'marked_as_spam' | 'user_declined' | 'error_llm_websocket_open' | 'error_llm_websocket_lost_connection' | 'error_llm_websocket_runtime' | 'error_llm_websocket_corrupt_payload' | 'error_no_audio_received' | 'error_asr' | 'error_retell' | 'error_unknown' | 'error_user_not_joined' | 'registered_call_timeout' | 'transfer_bridged' | 'transfer_cancelled' | 'manual_stopped'>;
+        call_cost?: V3WebCallResponse.CallCost;
         /**
-         * Only retrieve calls with specific range of duration(s).
+         * Dynamic variables collected from the call. Only available after the call ends.
          */
-        duration_ms?: FilterCriteria.DurationMs;
+        collected_dynamic_variables?: {
+            [key: string]: unknown;
+        };
         /**
-         * Filter by dynamic variables using dot notation (e.g., `dynamic_variables.name`).
-         * Values are matched exactly as strings.
+         * Custom SIP headers to be added to the call.
          */
-        dynamic_variables?: {
-            [key: string]: Array<string>;
+        custom_sip_headers?: {
+            [key: string]: string;
         };
-        e2e_latency_p50?: FilterCriteria.E2ELatencyP50;
         /**
-         * Only retrieve calls with specific range of end timestamp(s).
+         * Data storage setting for this call's agent. "everything" stores all data,
+         * "everything_except_pii" excludes PII when possible, "basic_attributes_only"
+         * stores only metadata.
+         */
+        data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only' | null;
+        /**
+         * The reason for the disconnection of the call. Read detailed description about
+         * reasons listed here at
+         * [Disconnection Reason Doc](/reliability/debug-call-disconnect#understanding-disconnection-reasons).
+         */
+        disconnection_reason?: 'user_hangup' | 'agent_hangup' | 'call_transfer' | 'voicemail_reached' | 'ivr_reached' | 'inactivity' | 'max_duration_reached' | 'concurrency_limit_reached' | 'no_valid_payment' | 'scam_detected' | 'dial_busy' | 'dial_failed' | 'dial_no_answer' | 'invalid_destination' | 'telephony_provider_permission_denied' | 'telephony_provider_unavailable' | 'sip_routing_error' | 'marked_as_spam' | 'user_declined' | 'error_llm_websocket_open' | 'error_llm_websocket_lost_connection' | 'error_llm_websocket_runtime' | 'error_llm_websocket_corrupt_payload' | 'error_no_audio_received' | 'error_asr' | 'error_retell' | 'error_unknown' | 'error_user_not_joined' | 'registered_call_timeout' | 'transfer_bridged' | 'transfer_cancelled' | 'manual_stopped';
+        /**
+         * Duration of the call in milliseconds. Available after call ends.
+         */
+        duration_ms?: number;
+        /**
+         * End timestamp (milliseconds since epoch) of the call. Available after call ends.
+         */
+        end_timestamp?: number;
+        /**
+         * URL to the knowledge base retrieved contents of the call. Available after call
+         * ends if the call utilizes knowledge base feature. It consists of the respond id
+         * and the retrieved contents related to that response. It's already rendered in
+         * call history tab of dashboard, and you can also manually download and check
+         * against the transcript to view the knowledge base retrieval results.
+         */
+        knowledge_base_retrieved_contents_url?: string;
+        /**
+         * Latency tracking of the call, available after call ends. Not all fields here
+         * will be available, as it depends on the type of call and feature used.
+         */
+        latency?: V3WebCallResponse.Latency;
+        /**
+         * LLM token usage of the call, available after call ends. Not populated if using
+         * custom LLM, realtime API, or no LLM call is made.
+         */
+        llm_token_usage?: V3WebCallResponse.LlmTokenUsage;
+        /**
+         * An arbitrary object for storage purpose only. You can put anything here like
+         * your internal customer id associated with the call. Not used for processing. You
+         * can later get this field from the call object.
+         */
+        metadata?: unknown;
+        /**
+         * Whether this agent opts in for signed URLs for public logs and recordings. When
+         * enabled, the generated URLs will include security signatures that restrict
+         * access and automatically expire after 24 hours.
+         */
+        opt_in_signed_url?: boolean;
+        /**
+         * Public log of the call, containing details about all the requests and responses
+         * received in LLM WebSocket, latency tracking for each turntaking, helpful for
+         * debugging and tracing. Available after call ends.
          */
-        end_timestamp?: FilterCriteria.EndTimestamp;
+        public_log_url?: string;
         /**
-         * Only retrieve calls with specific from number(s).
+         * Recording of the call, with each party's audio stored in a separate channel.
+         * Available after the call ends.
          */
-        from_number?: Array<string>;
+        recording_multi_channel_url?: string;
         /**
-         * Only retrieve calls that are in voicemail or not in voicemail.
+         * Recording of the call. Available after call ends.
          */
-        in_voicemail?: Array<boolean>;
+        recording_url?: string;
         /**
-         * Filter by metadata fields using dot notation (e.g., `metadata.customer_id`).
-         * Values are matched exactly as strings.
+         * Add optional dynamic variables in key value pairs of string that injects into
+         * your Response Engine prompt and tool description. Only applicable for Response
+         * Engine.
          */
-        metadata?: {
-            [key: string]: Array<string>;
+        retell_llm_dynamic_variables?: {
+            [key: string]: unknown;
         };
         /**
-         * Only retrieve calls with specific range of start timestamp(s).
+         * Recording of the call without PII, with each party's audio stored in a separate
+         * channel. Available after the call ends.
+         */
+        scrubbed_recording_multi_channel_url?: string;
+        /**
+         * Recording of the call without PII. Available after call ends.
          */
-        start_timestamp?: FilterCriteria.StartTimestamp;
+        scrubbed_recording_url?: string;
         /**
-         * Only retrieve calls with specific to number(s).
+         * Begin timestamp (milliseconds since epoch) of the call. Available after call
+         * starts.
          */
-        to_number?: Array<string>;
+        start_timestamp?: number;
         /**
-         * Only retrieve calls with specific user sentiment(s).
+         * The destination number or identifier where the call was transferred to. Only
+         * populated when the disconnection reason was `call_transfer`. Can be a phone
+         * number or a SIP URI. SIP URIs are prefixed with "sip:" and may include a
+         * ";transport=..." portion (if transport is known) where the transport type can be
+         * "tls", "tcp" or "udp".
          */
-        user_sentiment?: Array<'Negative' | 'Positive' | 'Neutral' | 'Unknown'>;
+        transfer_destination?: string | null;
         /**
-         * The version of the agent to use for the call.
+         * Transfer end timestamp (milliseconds since epoch) of the call. Available after
+         * transfer call ends.
          */
-        version?: Array<number>;
+        transfer_end_timestamp?: number;
     }
-    namespace FilterCriteria {
+    namespace V3WebCallResponse {
+        /**
+         * Post call analysis that includes information such as sentiment, status, summary,
+         * and custom defined data to extract. Available after call ends. Subscribe to
+         * `call_analyzed` webhook event type to receive it once ready.
+         */
+        interface CallAnalysis {
+            /**
+             * Whether the agent seems to have a successful call with the user, where the agent
+             * finishes the task, and the call was complete without being cutoff.
+             */
+            call_successful?: boolean;
+            /**
+             * A high level summary of the call.
+             */
+            call_summary?: string;
+            /**
+             * Custom analysis data that was extracted based on the schema defined in agent
+             * post call analysis data. Can be empty if nothing is specified.
+             */
+            custom_analysis_data?: unknown;
+            /**
+             * Whether the call is entered voicemail.
+             */
+            in_voicemail?: boolean;
+            /**
+             * Sentiment of the user in the call.
+             */
+            user_sentiment?: 'Negative' | 'Positive' | 'Neutral' | 'Unknown';
+        }
         /**
-         * Only retrieve calls with specific range of duration(s).
+         * Cost of the call, including all the products and their costs and discount.
          */
-        interface DurationMs {
-            lower_threshold?: number;
-            upper_threshold?: number;
+        interface CallCost {
+            /**
+             * Combined cost of all individual costs in cents
+             */
+            combined_cost: number;
+            /**
+             * List of products with their unit prices and costs in cents
+             */
+            product_costs: Array<CallCost.ProductCost>;
+            /**
+             * Total duration of the call in seconds
+             */
+            total_duration_seconds: number;
+            /**
+             * Total unit duration price of all products in cents per second
+             */
+            total_duration_unit_price: number;
         }
-        interface E2ELatencyP50 {
-            lower_threshold?: number;
-            upper_threshold?: number;
+        namespace CallCost {
+            interface ProductCost {
+                /**
+                 * Cost for the product in cents for the duration of the call.
+                 */
+                cost: number;
+                /**
+                 * Product name that has a cost associated with it.
+                 */
+                product: string;
+                /**
+                 * True if this cost item is for a transfer segment.
+                 */
+                is_transfer_leg_cost?: boolean;
+                /**
+                 * Unit price of the product in cents per second.
+                 */
+                unit_price?: number;
+            }
         }
         /**
-         * Only retrieve calls with specific range of end timestamp(s).
+         * Latency tracking of the call, available after call ends. Not all fields here
+         * will be available, as it depends on the type of call and feature used.
          */
-        interface EndTimestamp {
-            lower_threshold?: number;
-            upper_threshold?: number;
+        interface Latency {
+            /**
+             * Transcription latency (diff between the duration of the chunks streamed and the
+             * durations of the transcribed part) tracking of the call.
+             */
+            asr?: Latency.Asr;
+            /**
+             * End to end latency (from user stops talking to agent start talking) tracking of
+             * the call. This latency does not account for the network trip time from Retell
+             * server to user frontend. The latency is tracked every time turn change between
+             * user and agent.
+             */
+            e2e?: Latency.E2E;
+            /**
+             * Knowledge base latency (from the triggering of knowledge base retrival to all
+             * relevant context received) tracking of the call. Only populated when using
+             * knowledge base feature for the agent of the call.
+             */
+            knowledge_base?: Latency.KnowledgeBase;
+            /**
+             * LLM latency (from issue of LLM call to first speakable chunk received) tracking
+             * of the call. When using custom LLM. this latency includes LLM websocket
+             * roundtrip time between user server and Retell server.
+             */
+            llm?: Latency.Llm;
+            /**
+             * LLM websocket roundtrip latency (between user server and Retell server) tracking
+             * of the call. Only populated for calls using custom LLM.
+             */
+            llm_websocket_network_rtt?: Latency.LlmWebsocketNetworkRtt;
+            /**
+             * Speech-to-speech latency (from requesting responses of a S2S model to first byte
+             * received) tracking of the call. Only populated for calls that uses S2S model
+             * like Realtime API.
+             */
+            s2s?: Latency.S2s;
+            /**
+             * Text-to-speech latency (from the triggering of TTS to first byte received)
+             * tracking of the call.
+             */
+            tts?: Latency.Tts;
+        }
+        namespace Latency {
+            /**
+             * Transcription latency (diff between the duration of the chunks streamed and the
+             * durations of the transcribed part) tracking of the call.
+             */
+            interface Asr {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * End to end latency (from user stops talking to agent start talking) tracking of
+             * the call. This latency does not account for the network trip time from Retell
+             * server to user frontend. The latency is tracked every time turn change between
+             * user and agent.
+             */
+            interface E2E {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * Knowledge base latency (from the triggering of knowledge base retrival to all
+             * relevant context received) tracking of the call. Only populated when using
+             * knowledge base feature for the agent of the call.
+             */
+            interface KnowledgeBase {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * LLM latency (from issue of LLM call to first speakable chunk received) tracking
+             * of the call. When using custom LLM. this latency includes LLM websocket
+             * roundtrip time between user server and Retell server.
+             */
+            interface Llm {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * LLM websocket roundtrip latency (between user server and Retell server) tracking
+             * of the call. Only populated for calls using custom LLM.
+             */
+            interface LlmWebsocketNetworkRtt {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * Speech-to-speech latency (from requesting responses of a S2S model to first byte
+             * received) tracking of the call. Only populated for calls that uses S2S model
+             * like Realtime API.
+             */
+            interface S2s {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * Text-to-speech latency (from the triggering of TTS to first byte received)
+             * tracking of the call.
+             */
+            interface Tts {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
         }
         /**
-         * Only retrieve calls with specific range of start timestamp(s).
+         * LLM token usage of the call, available after call ends. Not populated if using
+         * custom LLM, realtime API, or no LLM call is made.
          */
-        interface StartTimestamp {
-            lower_threshold?: number;
-            upper_threshold?: number;
+        interface LlmTokenUsage {
+            /**
+             * Average token count of the call.
+             */
+            average: number;
+            /**
+             * Number of requests made to the LLM.
+             */
+            num_requests: number;
+            /**
+             * All the token count values in the call.
+             */
+            values: Array<number>;
+        }
+    }
+    interface V3PhoneCallResponse {
+        /**
+         * Corresponding agent id of this call.
+         */
+        agent_id: string;
+        /**
+         * The version of the agent.
+         */
+        agent_version: number;
+        /**
+         * Unique id of the call. Used to identify the call in the LLM websocket and used
+         * to authenticate in the audio websocket.
+         */
+        call_id: string;
+        /**
+         * Status of call.
+         *
+         * - `registered`: Call id issued, starting to make a call using this id.
+         * - `ongoing`: Call connected and ongoing.
+         * - `ended`: The underlying websocket has ended for the call. Either user or agent
+         *   hung up, or call transferred.
+         * - `error`: Call encountered error.
+         */
+        call_status: 'registered' | 'not_connected' | 'ongoing' | 'ended' | 'error';
+        /**
+         * Type of the call. Used to distinguish between web call and phone call.
+         */
+        call_type: 'phone_call';
+        /**
+         * Direction of the phone call.
+         */
+        direction: 'inbound' | 'outbound';
+        /**
+         * The caller number.
+         */
+        from_number: string;
+        /**
+         * The callee number.
+         */
+        to_number: string;
+        /**
+         * Name of the agent.
+         */
+        agent_name?: string;
+        /**
+         * Post call analysis that includes information such as sentiment, status, summary,
+         * and custom defined data to extract. Available after call ends. Subscribe to
+         * `call_analyzed` webhook event type to receive it once ready.
+         */
+        call_analysis?: V3PhoneCallResponse.CallAnalysis;
+        /**
+         * Cost of the call, including all the products and their costs and discount.
+         */
+        call_cost?: V3PhoneCallResponse.CallCost;
+        /**
+         * Dynamic variables collected from the call. Only available after the call ends.
+         */
+        collected_dynamic_variables?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Custom SIP headers to be added to the call.
+         */
+        custom_sip_headers?: {
+            [key: string]: string;
+        };
+        /**
+         * Data storage setting for this call's agent. "everything" stores all data,
+         * "everything_except_pii" excludes PII when possible, "basic_attributes_only"
+         * stores only metadata.
+         */
+        data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only' | null;
+        /**
+         * The reason for the disconnection of the call. Read detailed description about
+         * reasons listed here at
+         * [Disconnection Reason Doc](/reliability/debug-call-disconnect#understanding-disconnection-reasons).
+         */
+        disconnection_reason?: 'user_hangup' | 'agent_hangup' | 'call_transfer' | 'voicemail_reached' | 'ivr_reached' | 'inactivity' | 'max_duration_reached' | 'concurrency_limit_reached' | 'no_valid_payment' | 'scam_detected' | 'dial_busy' | 'dial_failed' | 'dial_no_answer' | 'invalid_destination' | 'telephony_provider_permission_denied' | 'telephony_provider_unavailable' | 'sip_routing_error' | 'marked_as_spam' | 'user_declined' | 'error_llm_websocket_open' | 'error_llm_websocket_lost_connection' | 'error_llm_websocket_runtime' | 'error_llm_websocket_corrupt_payload' | 'error_no_audio_received' | 'error_asr' | 'error_retell' | 'error_unknown' | 'error_user_not_joined' | 'registered_call_timeout' | 'transfer_bridged' | 'transfer_cancelled' | 'manual_stopped';
+        /**
+         * Duration of the call in milliseconds. Available after call ends.
+         */
+        duration_ms?: number;
+        /**
+         * End timestamp (milliseconds since epoch) of the call. Available after call ends.
+         */
+        end_timestamp?: number;
+        /**
+         * URL to the knowledge base retrieved contents of the call. Available after call
+         * ends if the call utilizes knowledge base feature. It consists of the respond id
+         * and the retrieved contents related to that response. It's already rendered in
+         * call history tab of dashboard, and you can also manually download and check
+         * against the transcript to view the knowledge base retrieval results.
+         */
+        knowledge_base_retrieved_contents_url?: string;
+        /**
+         * Latency tracking of the call, available after call ends. Not all fields here
+         * will be available, as it depends on the type of call and feature used.
+         */
+        latency?: V3PhoneCallResponse.Latency;
+        /**
+         * LLM token usage of the call, available after call ends. Not populated if using
+         * custom LLM, realtime API, or no LLM call is made.
+         */
+        llm_token_usage?: V3PhoneCallResponse.LlmTokenUsage;
+        /**
+         * An arbitrary object for storage purpose only. You can put anything here like
+         * your internal customer id associated with the call. Not used for processing. You
+         * can later get this field from the call object.
+         */
+        metadata?: unknown;
+        /**
+         * Whether this agent opts in for signed URLs for public logs and recordings. When
+         * enabled, the generated URLs will include security signatures that restrict
+         * access and automatically expire after 24 hours.
+         */
+        opt_in_signed_url?: boolean;
+        /**
+         * Public log of the call, containing details about all the requests and responses
+         * received in LLM WebSocket, latency tracking for each turntaking, helpful for
+         * debugging and tracing. Available after call ends.
+         */
+        public_log_url?: string;
+        /**
+         * Recording of the call, with each party's audio stored in a separate channel.
+         * Available after the call ends.
+         */
+        recording_multi_channel_url?: string;
+        /**
+         * Recording of the call. Available after call ends.
+         */
+        recording_url?: string;
+        /**
+         * Add optional dynamic variables in key value pairs of string that injects into
+         * your Response Engine prompt and tool description. Only applicable for Response
+         * Engine.
+         */
+        retell_llm_dynamic_variables?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Recording of the call without PII, with each party's audio stored in a separate
+         * channel. Available after the call ends.
+         */
+        scrubbed_recording_multi_channel_url?: string;
+        /**
+         * Recording of the call without PII. Available after call ends.
+         */
+        scrubbed_recording_url?: string;
+        /**
+         * Begin timestamp (milliseconds since epoch) of the call. Available after call
+         * starts.
+         */
+        start_timestamp?: number;
+        /**
+         * Telephony identifier of the call, populated when available. Tracking purposes
+         * only.
+         */
+        telephony_identifier?: V3PhoneCallResponse.TelephonyIdentifier;
+        /**
+         * The destination number or identifier where the call was transferred to. Only
+         * populated when the disconnection reason was `call_transfer`. Can be a phone
+         * number or a SIP URI. SIP URIs are prefixed with "sip:" and may include a
+         * ";transport=..." portion (if transport is known) where the transport type can be
+         * "tls", "tcp" or "udp".
+         */
+        transfer_destination?: string | null;
+        /**
+         * Transfer end timestamp (milliseconds since epoch) of the call. Available after
+         * transfer call ends.
+         */
+        transfer_end_timestamp?: number;
+    }
+    namespace V3PhoneCallResponse {
+        /**
+         * Post call analysis that includes information such as sentiment, status, summary,
+         * and custom defined data to extract. Available after call ends. Subscribe to
+         * `call_analyzed` webhook event type to receive it once ready.
+         */
+        interface CallAnalysis {
+            /**
+             * Whether the agent seems to have a successful call with the user, where the agent
+             * finishes the task, and the call was complete without being cutoff.
+             */
+            call_successful?: boolean;
+            /**
+             * A high level summary of the call.
+             */
+            call_summary?: string;
+            /**
+             * Custom analysis data that was extracted based on the schema defined in agent
+             * post call analysis data. Can be empty if nothing is specified.
+             */
+            custom_analysis_data?: unknown;
+            /**
+             * Whether the call is entered voicemail.
+             */
+            in_voicemail?: boolean;
+            /**
+             * Sentiment of the user in the call.
+             */
+            user_sentiment?: 'Negative' | 'Positive' | 'Neutral' | 'Unknown';
+        }
+        /**
+         * Cost of the call, including all the products and their costs and discount.
+         */
+        interface CallCost {
+            /**
+             * Combined cost of all individual costs in cents
+             */
+            combined_cost: number;
+            /**
+             * List of products with their unit prices and costs in cents
+             */
+            product_costs: Array<CallCost.ProductCost>;
+            /**
+             * Total duration of the call in seconds
+             */
+            total_duration_seconds: number;
+            /**
+             * Total unit duration price of all products in cents per second
+             */
+            total_duration_unit_price: number;
+        }
+        namespace CallCost {
+            interface ProductCost {
+                /**
+                 * Cost for the product in cents for the duration of the call.
+                 */
+                cost: number;
+                /**
+                 * Product name that has a cost associated with it.
+                 */
+                product: string;
+                /**
+                 * True if this cost item is for a transfer segment.
+                 */
+                is_transfer_leg_cost?: boolean;
+                /**
+                 * Unit price of the product in cents per second.
+                 */
+                unit_price?: number;
+            }
+        }
+        /**
+         * Latency tracking of the call, available after call ends. Not all fields here
+         * will be available, as it depends on the type of call and feature used.
+         */
+        interface Latency {
+            /**
+             * Transcription latency (diff between the duration of the chunks streamed and the
+             * durations of the transcribed part) tracking of the call.
+             */
+            asr?: Latency.Asr;
+            /**
+             * End to end latency (from user stops talking to agent start talking) tracking of
+             * the call. This latency does not account for the network trip time from Retell
+             * server to user frontend. The latency is tracked every time turn change between
+             * user and agent.
+             */
+            e2e?: Latency.E2E;
+            /**
+             * Knowledge base latency (from the triggering of knowledge base retrival to all
+             * relevant context received) tracking of the call. Only populated when using
+             * knowledge base feature for the agent of the call.
+             */
+            knowledge_base?: Latency.KnowledgeBase;
+            /**
+             * LLM latency (from issue of LLM call to first speakable chunk received) tracking
+             * of the call. When using custom LLM. this latency includes LLM websocket
+             * roundtrip time between user server and Retell server.
+             */
+            llm?: Latency.Llm;
+            /**
+             * LLM websocket roundtrip latency (between user server and Retell server) tracking
+             * of the call. Only populated for calls using custom LLM.
+             */
+            llm_websocket_network_rtt?: Latency.LlmWebsocketNetworkRtt;
+            /**
+             * Speech-to-speech latency (from requesting responses of a S2S model to first byte
+             * received) tracking of the call. Only populated for calls that uses S2S model
+             * like Realtime API.
+             */
+            s2s?: Latency.S2s;
+            /**
+             * Text-to-speech latency (from the triggering of TTS to first byte received)
+             * tracking of the call.
+             */
+            tts?: Latency.Tts;
+        }
+        namespace Latency {
+            /**
+             * Transcription latency (diff between the duration of the chunks streamed and the
+             * durations of the transcribed part) tracking of the call.
+             */
+            interface Asr {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * End to end latency (from user stops talking to agent start talking) tracking of
+             * the call. This latency does not account for the network trip time from Retell
+             * server to user frontend. The latency is tracked every time turn change between
+             * user and agent.
+             */
+            interface E2E {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * Knowledge base latency (from the triggering of knowledge base retrival to all
+             * relevant context received) tracking of the call. Only populated when using
+             * knowledge base feature for the agent of the call.
+             */
+            interface KnowledgeBase {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * LLM latency (from issue of LLM call to first speakable chunk received) tracking
+             * of the call. When using custom LLM. this latency includes LLM websocket
+             * roundtrip time between user server and Retell server.
+             */
+            interface Llm {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * LLM websocket roundtrip latency (between user server and Retell server) tracking
+             * of the call. Only populated for calls using custom LLM.
+             */
+            interface LlmWebsocketNetworkRtt {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * Speech-to-speech latency (from requesting responses of a S2S model to first byte
+             * received) tracking of the call. Only populated for calls that uses S2S model
+             * like Realtime API.
+             */
+            interface S2s {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+            /**
+             * Text-to-speech latency (from the triggering of TTS to first byte received)
+             * tracking of the call.
+             */
+            interface Tts {
+                /**
+                 * Maximum latency in the call, measured in milliseconds.
+                 */
+                max?: number;
+                /**
+                 * Minimum latency in the call, measured in milliseconds.
+                 */
+                min?: number;
+                /**
+                 * Number of data points (number of times latency is tracked).
+                 */
+                num?: number;
+                /**
+                 * 50 percentile of latency, measured in milliseconds.
+                 */
+                p50?: number;
+                /**
+                 * 90 percentile of latency, measured in milliseconds.
+                 */
+                p90?: number;
+                /**
+                 * 95 percentile of latency, measured in milliseconds.
+                 */
+                p95?: number;
+                /**
+                 * 99 percentile of latency, measured in milliseconds.
+                 */
+                p99?: number;
+                /**
+                 * All the latency data points in the call, measured in milliseconds.
+                 */
+                values?: Array<number>;
+            }
+        }
+        /**
+         * LLM token usage of the call, available after call ends. Not populated if using
+         * custom LLM, realtime API, or no LLM call is made.
+         */
+        interface LlmTokenUsage {
+            /**
+             * Average token count of the call.
+             */
+            average: number;
+            /**
+             * Number of requests made to the LLM.
+             */
+            num_requests: number;
+            /**
+             * All the token count values in the call.
+             */
+            values: Array<number>;
+        }
+        /**
+         * Telephony identifier of the call, populated when available. Tracking purposes
+         * only.
+         */
+        interface TelephonyIdentifier {
+            /**
+             * Twilio call sid.
+             */
+            twilio_call_sid?: string;
+        }
+    }
+}
+export interface CallUpdateParams {
+    /**
+     * Custom attributes for the call
+     */
+    custom_attributes?: {
+        [key: string]: string | number | boolean;
+    };
+    /**
+     * Data storage setting for this call. Overrides the agent's default setting.
+     * "everything" stores all data, "everything_except_pii" excludes PII when
+     * possible, "basic_attributes_only" stores only metadata. Cannot be downgraded
+     * from more restrictive to less restrictive settings.
+     */
+    data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only';
+    /**
+     * An arbitrary object for storage purpose only. You can put anything here like
+     * your internal customer id associated with the call. Not used for processing. You
+     * can later get this field from the call object. Size limited to 50kB max.
+     */
+    metadata?: unknown;
+    /**
+     * Override dynamic varaibles represented as key-value pairs of strings. Setting
+     * this will override or add the dynamic variables set in the agent during the
+     * call. Only need to set the delta where you want to override, no need to set the
+     * entire dynamic variables object. Setting this to null will remove any existing
+     * override.
+     */
+    override_dynamic_variables?: {
+        [key: string]: string;
+    } | null;
+}
+export interface CallListParams {
+    /**
+     * Filter criteria for calls. All conditions are implicitly connected with AND.
+     */
+    filter_criteria?: CallListParams.FilterCriteria;
+    /**
+     * Maximum number of calls to return.
+     */
+    limit?: number;
+    /**
+     * Opaque pagination cursor from a previous response.
+     */
+    pagination_key?: string;
+    /**
+     * Number of records to skip for pagination.
+     */
+    skip?: number;
+    /**
+     * Sort calls by `start_timestamp` in ascending or descending order.
+     */
+    sort_order?: 'ascending' | 'descending';
+}
+export declare namespace CallListParams {
+    /**
+     * Filter criteria for calls. All conditions are implicitly connected with AND.
+     */
+    interface FilterCriteria {
+        /**
+         * Filter by agent(s). Agent filters are connected by OR.
+         */
+        agent?: Array<FilterCriteria.Agent>;
+        /**
+         * Filter by batch call ID.
+         */
+        batch_call_id?: FilterCriteria.BatchCallID;
+        /**
+         * Filter by call ID.
+         */
+        call_id?: FilterCriteria.CallID;
+        call_status?: FilterCriteria.CallStatus;
+        /**
+         * Filter by whether the call was successful.
+         */
+        call_successful?: FilterCriteria.CallSuccessful;
+        call_type?: FilterCriteria.CallType;
+        /**
+         * Filter by combined cost of the call.
+         */
+        combined_cost?: FilterCriteria.NumberFilter | FilterCriteria.RangeFilter;
+        /**
+         * Filter by custom analysis data fields.
+         */
+        custom_analysis_data?: Array<FilterCriteria.StringFilter | FilterCriteria.NumberFilter | FilterCriteria.BooleanFilter | FilterCriteria.RangeFilter | FilterCriteria.EnumFilter | FilterCriteria.PresentFilter>;
+        /**
+         * Filter by custom attributes fields.
+         */
+        custom_attributes?: Array<FilterCriteria.StringFilter | FilterCriteria.NumberFilter | FilterCriteria.BooleanFilter | FilterCriteria.RangeFilter | FilterCriteria.EnumFilter | FilterCriteria.PresentFilter>;
+        data_storage_setting?: FilterCriteria.DataStorageSetting;
+        direction?: FilterCriteria.Direction;
+        disconnection_reason?: FilterCriteria.DisconnectionReason;
+        /**
+         * Filter by call duration in milliseconds.
+         */
+        duration_ms?: FilterCriteria.NumberFilter | FilterCriteria.RangeFilter;
+        /**
+         * Filter by dynamic variables.
+         */
+        dynamic_variables?: Array<FilterCriteria.DynamicVariable>;
+        /**
+         * Filter by end-to-end latency p50.
+         */
+        e2e_latency_p50?: FilterCriteria.NumberFilter | FilterCriteria.RangeFilter;
+        /**
+         * Filter by call end timestamp (epoch ms).
+         */
+        end_timestamp?: FilterCriteria.NumberFilter | FilterCriteria.RangeFilter;
+        /**
+         * Filter by from number.
+         */
+        from_number?: FilterCriteria.FromNumber;
+        /**
+         * Filter by whether the call is in voicemail.
+         */
+        in_voicemail?: FilterCriteria.InVoicemail;
+        /**
+         * Filter by metadata fields.
+         */
+        metadata?: Array<FilterCriteria.StringFilter | FilterCriteria.NumberFilter | FilterCriteria.BooleanFilter | FilterCriteria.RangeFilter | FilterCriteria.EnumFilter | FilterCriteria.PresentFilter>;
+        /**
+         * Filter by call start timestamp (epoch ms).
+         */
+        start_timestamp?: FilterCriteria.NumberFilter | FilterCriteria.RangeFilter;
+        /**
+         * Filter by to number.
+         */
+        to_number?: FilterCriteria.ToNumber;
+        /**
+         * Filter by tool call criteria. Tool call filters are connected by AND.
+         */
+        tool_calls?: Array<FilterCriteria.ToolCall>;
+        user_sentiment?: FilterCriteria.UserSentiment;
+    }
+    namespace FilterCriteria {
+        interface Agent {
+            /**
+             * The agent ID to filter on.
+             */
+            agent_id: string;
+            /**
+             * Specific versions to filter on. If not provided, all versions are included.
+             */
+            version?: Array<number>;
+        }
+        /**
+         * Filter by batch call ID.
+         */
+        interface BatchCallID {
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+        }
+        /**
+         * Filter by call ID.
+         */
+        interface CallID {
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+        }
+        interface CallStatus {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<'not_connected' | 'ongoing' | 'ended' | 'error'>;
+        }
+        /**
+         * Filter by whether the call was successful.
+         */
+        interface CallSuccessful {
+            op: 'eq';
+            type: 'boolean';
+            value: boolean;
+        }
+        interface CallType {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<'web_call' | 'phone_call'>;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+        }
+        interface StringFilter {
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface BooleanFilter {
+            op: 'eq';
+            type: 'boolean';
+            value: boolean;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface EnumFilter {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<string>;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface PresentFilter {
+            /**
+             * pr: present (has value), np: not present
+             */
+            op: 'pr' | 'np';
+            type: 'present';
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface StringFilter {
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface BooleanFilter {
+            op: 'eq';
+            type: 'boolean';
+            value: boolean;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface EnumFilter {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<string>;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface PresentFilter {
+            /**
+             * pr: present (has value), np: not present
+             */
+            op: 'pr' | 'np';
+            type: 'present';
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface DataStorageSetting {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<'everything' | 'everything_except_pii' | 'basic_attributes_only'>;
+        }
+        interface Direction {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<'inbound' | 'outbound'>;
+        }
+        interface DisconnectionReason {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<'user_hangup' | 'agent_hangup' | 'call_transfer' | 'voicemail_reached' | 'ivr_reached' | 'inactivity' | 'max_duration_reached' | 'concurrency_limit_reached' | 'no_valid_payment' | 'scam_detected' | 'dial_busy' | 'dial_failed' | 'dial_no_answer' | 'invalid_destination' | 'telephony_provider_permission_denied' | 'telephony_provider_unavailable' | 'sip_routing_error' | 'marked_as_spam' | 'user_declined' | 'error_llm_websocket_open' | 'error_llm_websocket_lost_connection' | 'error_llm_websocket_runtime' | 'error_llm_websocket_corrupt_payload' | 'error_no_audio_received' | 'error_asr' | 'error_retell' | 'error_unknown' | 'error_user_not_joined' | 'registered_call_timeout' | 'transfer_bridged' | 'transfer_cancelled' | 'manual_stopped'>;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+        }
+        interface DynamicVariable {
+            /**
+             * The dynamic variable name to filter on.
+             */
+            key: string;
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+        }
+        /**
+         * Filter by from number.
+         */
+        interface FromNumber {
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+        }
+        /**
+         * Filter by whether the call is in voicemail.
+         */
+        interface InVoicemail {
+            op: 'eq';
+            type: 'boolean';
+            value: boolean;
+        }
+        interface StringFilter {
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface BooleanFilter {
+            op: 'eq';
+            type: 'boolean';
+            value: boolean;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface EnumFilter {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<string>;
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface PresentFilter {
+            /**
+             * pr: present (has value), np: not present
+             */
+            op: 'pr' | 'np';
+            type: 'present';
+            /**
+             * The field name to filter on.
+             */
+            key?: string;
+        }
+        interface NumberFilter {
+            /**
+             * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+             * than, le: less than or equal
+             */
+            op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+            type: 'number';
+            value: number;
+        }
+        interface RangeFilter {
+            /**
+             * bt: between
+             */
+            op: 'bt';
+            type: 'range';
+            /**
+             * [lower_bound, upper_bound]
+             */
+            value: Array<number>;
+        }
+        /**
+         * Filter by to number.
+         */
+        interface ToNumber {
+            /**
+             * eq: equal, ne: not equal, sw: starts with, ew: ends with, co: contains
+             */
+            op: 'eq' | 'ne' | 'sw' | 'ew' | 'co';
+            type: 'string';
+            value: string;
+        }
+        interface ToolCall {
+            /**
+             * The tool call name to filter on.
+             */
+            name: string;
+            /**
+             * Filter by tool call latency in milliseconds.
+             */
+            latency_ms?: ToolCall.NumberFilter | ToolCall.RangeFilter;
+            /**
+             * Filter by tool call success status.
+             */
+            success?: ToolCall.Success;
+        }
+        namespace ToolCall {
+            interface NumberFilter {
+                /**
+                 * eq: equal, ne: not equal, gt: greater than, ge: greater than or equal, lt: less
+                 * than, le: less than or equal
+                 */
+                op: 'eq' | 'ne' | 'gt' | 'ge' | 'lt' | 'le';
+                type: 'number';
+                value: number;
+            }
+            interface RangeFilter {
+                /**
+                 * bt: between
+                 */
+                op: 'bt';
+                type: 'range';
+                /**
+                 * [lower_bound, upper_bound]
+                 */
+                value: Array<number>;
+            }
+            /**
+             * Filter by tool call success status.
+             */
+            interface Success {
+                op: 'eq';
+                type: 'boolean';
+                value: boolean;
+            }
+        }
+        interface UserSentiment {
+            /**
+             * in: value is one of the listed values
+             */
+            op: 'in';
+            type: 'enum';
+            value: Array<'Negative' | 'Positive' | 'Neutral' | 'Unknown'>;
         }
     }
 }
@@ -2380,7 +4014,7 @@ export declare namespace CallCreatePhoneCallParams {
              * available voice models. Set to null to remove voice model selection, and default
              * ones will apply. Check out dashboard for more details of each voice model.
              */
-            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | null;
+            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | null;
             /**
              * Controls speed of voice. Value ranging from [0.5,2]. Lower value means slower
              * speech, while higher value means faster speech rate. If unset, default value 1
@@ -2927,7 +4561,7 @@ export declare namespace CallCreatePhoneCallParams {
              * Select the underlying speech to speech model. Can only set this or model, not
              * both.
              */
-            s2s_model?: 'gpt-realtime-1.5' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
+            s2s_model?: 'gpt-realtime-2' | 'gpt-realtime-1.5' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
             /**
              * The speaker who starts the conversation. Required. Must be either 'user' or
              * 'agent'.
@@ -3329,7 +4963,7 @@ export declare namespace CallCreateWebCallParams {
              * available voice models. Set to null to remove voice model selection, and default
              * ones will apply. Check out dashboard for more details of each voice model.
              */
-            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | null;
+            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | null;
             /**
              * Controls speed of voice. Value ranging from [0.5,2]. Lower value means slower
              * speech, while higher value means faster speech rate. If unset, default value 1
@@ -3876,7 +5510,7 @@ export declare namespace CallCreateWebCallParams {
              * Select the underlying speech to speech model. Can only set this or model, not
              * both.
              */
-            s2s_model?: 'gpt-realtime-1.5' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
+            s2s_model?: 'gpt-realtime-2' | 'gpt-realtime-1.5' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
             /**
              * The speaker who starts the conversation. Required. Must be either 'user' or
              * 'agent'.
@@ -4277,7 +5911,7 @@ export declare namespace CallRegisterPhoneCallParams {
              * available voice models. Set to null to remove voice model selection, and default
              * ones will apply. Check out dashboard for more details of each voice model.
              */
-            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | null;
+            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | null;
             /**
              * Controls speed of voice. Value ranging from [0.5,2]. Lower value means slower
              * speech, while higher value means faster speech rate. If unset, default value 1
@@ -4824,7 +6458,7 @@ export declare namespace CallRegisterPhoneCallParams {
              * Select the underlying speech to speech model. Can only set this or model, not
              * both.
              */
-            s2s_model?: 'gpt-realtime-1.5' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
+            s2s_model?: 'gpt-realtime-2' | 'gpt-realtime-1.5' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
             /**
              * The speaker who starts the conversation. Required. Must be either 'user' or
              * 'agent'.