retell-sdk 5.22.0 → 5.24.0

package/src/resources/call.ts

@@ -43,12 +43,15 @@ export class Call extends APIResource {
   }
 
   /**
-   * 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> {
-    return this._client.post('/v2/list-calls', {
+  list(body: CallListParams | null | undefined = {}, options?: RequestOptions): APIPromise<CallListResponse> {
+    return this._client.post('/v3/list-calls', {
       body,
       timeout: (this._client as any)._options.timeout ?? 300000,
       ...options,
@@ -2281,110 +2284,100 @@ export namespace WebCallResponse {
   }
 }
 
-export type CallListResponse = Array<CallResponse>;
-
-export interface CallUpdateParams {
-  /**
-   * Custom attributes for the call
-   */
-  custom_attributes?: { [key: string]: string | number | boolean };
-
+export interface CallListResponse {
   /**
-   * 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.
+   * Whether more results are available.
    */
-  data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only';
+  has_more?: boolean;
 
-  /**
-   * 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;
+  items?: Array<CallListResponse.V3WebCallResponse | CallListResponse.V3PhoneCallResponse>;
 
   /**
-   * 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.
+   * Pagination key for the next page.
    */
-  override_dynamic_variables?: { [key: string]: string } | null;
+  pagination_key?: string;
 }
 
-export interface CallListParams {
-  /**
-   * Filter criteria for the calls to retrieve.
-   */
-  filter_criteria?: CallListParams.FilterCriteria;
+export namespace CallListResponse {
+  export 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;
 
-  /**
-   * Limit the number of calls returned. Default 50, Max 1000. To retrieve more than
-   * 1000, use pagination_key to continue fetching the next page.
-   */
-  limit?: number;
+    /**
+     * Corresponding agent id of this call.
+     */
+    agent_id: string;
 
-  /**
-   * 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?: string;
+    /**
+     * The version of the agent.
+     */
+    agent_version: number;
 
-  /**
-   * The calls will be sorted by `start_timestamp`, whether to return the calls in
-   * ascending or descending order.
-   */
-  sort_order?: 'ascending' | 'descending';
-}
+    /**
+     * 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';
 
-export namespace CallListParams {
-  /**
-   * Filter criteria for the calls to retrieve.
-   */
-  export interface FilterCriteria {
     /**
-     * Only retrieve calls that are made with specific agent(s).
+     * Type of the call. Used to distinguish between web call and phone call.
      */
-    agent_id?: Array<string>;
+    call_type: 'web_call';
 
     /**
-     * Only retrieve calls with specific batch call id(s).
+     * Name of the agent.
      */
-    batch_call_id?: Array<string>;
+    agent_name?: string;
 
     /**
-     * Only retrieve calls with specific call id(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.
      */
-    call_id?: Array<string>;
+    call_analysis?: V3WebCallResponse.CallAnalysis;
 
     /**
-     * Only retrieve calls with specific call status(es).
+     * Cost of the call, including all the products and their costs and discount.
      */
-    call_status?: Array<'not_connected' | 'ongoing' | 'ended' | 'error'>;
+    call_cost?: V3WebCallResponse.CallCost;
 
     /**
-     * Only retrieve calls with specific call successful(s).
+     * Dynamic variables collected from the call. Only available after the call ends.
      */
-    call_successful?: Array<boolean>;
+    collected_dynamic_variables?: { [key: string]: unknown };
 
     /**
-     * Only retrieve calls with specific call type(s).
+     * Custom SIP headers to be added to the call.
      */
-    call_type?: Array<'web_call' | 'phone_call'>;
+    custom_sip_headers?: { [key: string]: string };
 
     /**
-     * Only retrieve calls with specific direction(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.
      */
-    direction?: Array<'inbound' | 'outbound'>;
+    data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only' | null;
 
     /**
-     * Only retrieve calls with specific disconnection reason(s).
+     * 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?: Array<
+    disconnection_reason?:
       | 'user_hangup'
       | 'agent_hangup'
       | 'call_transfer'
@@ -2416,96 +2409,2186 @@ export namespace CallListParams {
       | 'registered_call_timeout'
       | 'transfer_bridged'
       | 'transfer_cancelled'
-      | 'manual_stopped'
-    >;
+      | '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;
 
     /**
-     * Only retrieve calls with specific range of duration(s).
+     * 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.
      */
-    duration_ms?: FilterCriteria.DurationMs;
+    knowledge_base_retrieved_contents_url?: string;
 
     /**
-     * Filter by dynamic variables using dot notation (e.g., `dynamic_variables.name`).
-     * Values are matched exactly as strings.
+     * 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.
      */
-    dynamic_variables?: { [key: string]: Array<string> };
+    latency?: V3WebCallResponse.Latency;
 
-    e2e_latency_p50?: FilterCriteria.E2ELatencyP50;
+    /**
+     * 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;
 
     /**
-     * Only retrieve calls with specific range of end timestamp(s).
+     * 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.
      */
-    start_timestamp?: FilterCriteria.StartTimestamp;
+    scrubbed_recording_multi_channel_url?: string;
 
     /**
-     * Only retrieve calls with specific to number(s).
+     * Recording of the call without PII. Available after call ends.
      */
-    to_number?: Array<string>;
+    scrubbed_recording_url?: string;
 
     /**
-     * Only retrieve calls with specific user sentiment(s).
+     * Begin timestamp (milliseconds since epoch) of the call. Available after call
+     * starts.
      */
-    user_sentiment?: Array<'Negative' | 'Positive' | 'Neutral' | 'Unknown'>;
+    start_timestamp?: number;
 
     /**
-     * The version of the agent to use for the call.
+     * 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".
      */
-    version?: Array<number>;
+    transfer_destination?: string | null;
+
+    /**
+     * Transfer end timestamp (milliseconds since epoch) of the call. Available after
+     * transfer call ends.
+     */
+    transfer_end_timestamp?: number;
   }
 
-  export namespace FilterCriteria {
+  export namespace V3WebCallResponse {
     /**
-     * Only retrieve calls with specific range of duration(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.
      */
-    export interface DurationMs {
-      lower_threshold?: number;
+    export 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;
 
-      upper_threshold?: number;
-    }
+      /**
+       * 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;
 
-    export interface E2ELatencyP50 {
-      lower_threshold?: number;
+      /**
+       * Whether the call is entered voicemail.
+       */
+      in_voicemail?: boolean;
 
-      upper_threshold?: number;
+      /**
+       * Sentiment of the user in the call.
+       */
+      user_sentiment?: 'Negative' | 'Positive' | 'Neutral' | 'Unknown';
     }
 
     /**
-     * Only retrieve calls with specific range of end timestamp(s).
+     * Cost of the call, including all the products and their costs and discount.
      */
-    export interface EndTimestamp {
-      lower_threshold?: number;
+    export 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;
 
-      upper_threshold?: number;
+      /**
+       * Total unit duration price of all products in cents per second
+       */
+      total_duration_unit_price: number;
+    }
+
+    export namespace CallCost {
+      export 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 start 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.
      */
-    export interface StartTimestamp {
-      lower_threshold?: number;
+    export 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;
+    }
+
+    export namespace Latency {
+      /**
+       * Transcription latency (diff between the duration of the chunks streamed and the
+       * durations of the transcribed part) tracking of the call.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+     */
+    export 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>;
+    }
+  }
+
+  export 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;
+  }
+
+  export 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.
+     */
+    export 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.
+     */
+    export 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;
+    }
+
+    export namespace CallCost {
+      export 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.
+     */
+    export 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;
+    }
+
+    export namespace Latency {
+      /**
+       * Transcription latency (diff between the duration of the chunks streamed and the
+       * durations of the transcribed part) tracking of the call.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export 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.
+     */
+    export 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.
+     */
+    export 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 namespace CallListParams {
+  /**
+   * Filter criteria for calls. All conditions are implicitly connected with AND.
+   */
+  export 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;
+  }
+
+  export namespace FilterCriteria {
+    export 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.
+     */
+    export 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.
+     */
+    export 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;
+    }
+
+    export 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.
+     */
+    export interface CallSuccessful {
+      op: 'eq';
+
+      type: 'boolean';
+
+      value: boolean;
+    }
+
+    export interface CallType {
+      /**
+       * in: value is one of the listed values
+       */
+      op: 'in';
+
+      type: 'enum';
+
+      value: Array<'web_call' | 'phone_call'>;
+    }
+
+    export 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;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+    }
+
+    export 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;
+    }
+
+    export 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;
+    }
+
+    export interface BooleanFilter {
+      op: 'eq';
+
+      type: 'boolean';
+
+      value: boolean;
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export 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;
+    }
+
+    export interface PresentFilter {
+      /**
+       * pr: present (has value), np: not present
+       */
+      op: 'pr' | 'np';
+
+      type: 'present';
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export 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;
+    }
+
+    export 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;
+    }
+
+    export interface BooleanFilter {
+      op: 'eq';
+
+      type: 'boolean';
+
+      value: boolean;
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export 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;
+    }
+
+    export interface PresentFilter {
+      /**
+       * pr: present (has value), np: not present
+       */
+      op: 'pr' | 'np';
+
+      type: 'present';
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export interface DataStorageSetting {
+      /**
+       * in: value is one of the listed values
+       */
+      op: 'in';
+
+      type: 'enum';
+
+      value: Array<'everything' | 'everything_except_pii' | 'basic_attributes_only'>;
+    }
+
+    export interface Direction {
+      /**
+       * in: value is one of the listed values
+       */
+      op: 'in';
+
+      type: 'enum';
+
+      value: Array<'inbound' | 'outbound'>;
+    }
+
+    export 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'
+      >;
+    }
+
+    export 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;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+    }
+
+    export 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;
+    }
+
+    export 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;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+    }
+
+    export 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;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+    }
+
+    /**
+     * Filter by from number.
+     */
+    export 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.
+     */
+    export interface InVoicemail {
+      op: 'eq';
+
+      type: 'boolean';
+
+      value: boolean;
+    }
+
+    export 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;
+    }
+
+    export 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;
+    }
+
+    export interface BooleanFilter {
+      op: 'eq';
+
+      type: 'boolean';
+
+      value: boolean;
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export 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;
+    }
+
+    export interface PresentFilter {
+      /**
+       * pr: present (has value), np: not present
+       */
+      op: 'pr' | 'np';
+
+      type: 'present';
+
+      /**
+       * The field name to filter on.
+       */
+      key?: string;
+    }
+
+    export 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;
+    }
+
+    export interface RangeFilter {
+      /**
+       * bt: between
+       */
+      op: 'bt';
+
+      type: 'range';
+
+      /**
+       * [lower_bound, upper_bound]
+       */
+      value: Array<number>;
+    }
+
+    /**
+     * Filter by to number.
+     */
+    export 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;
+    }
+
+    export 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;
+    }
+
+    export namespace ToolCall {
+      export 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;
+      }
+
+      export interface RangeFilter {
+        /**
+         * bt: between
+         */
+        op: 'bt';
+
+        type: 'range';
+
+        /**
+         * [lower_bound, upper_bound]
+         */
+        value: Array<number>;
+      }
+
+      /**
+       * Filter by tool call success status.
+       */
+      export interface Success {
+        op: 'eq';
+
+        type: 'boolean';
+
+        value: boolean;
+      }
+    }
+
+    export interface UserSentiment {
+      /**
+       * in: value is one of the listed values
+       */
+      op: 'in';
+
+      type: 'enum';
 
-      upper_threshold?: number;
+      value: Array<'Negative' | 'Positive' | 'Neutral' | 'Unknown'>;
     }
   }
 }
@@ -3124,12 +5207,14 @@ export namespace CallCreatePhoneCallParams {
         | '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;
 
       /**
@@ -3850,7 +5935,7 @@ export 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
@@ -4485,12 +6570,14 @@ export namespace CallCreateWebCallParams {
         | '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;
 
       /**
@@ -5211,7 +7298,7 @@ export 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
@@ -5846,12 +7933,14 @@ export namespace CallRegisterPhoneCallParams {
         | '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;
 
       /**
@@ -6572,7 +8661,7 @@ export 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