retell-sdk 4.65.0 → 5.0.0

package/resources/call.d.ts

@@ -1,5 +1,6 @@
-import { APIResource } from "../resource.js";
-import * as Core from "../core.js";
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
 export declare class Call extends APIResource {
     /**
      * Retrieve details of a specific call
@@ -11,7 +12,7 @@ export declare class Call extends APIResource {
      * );
      * ```
      */
-    retrieve(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallResponse>;
+    retrieve(callID: string, options?: RequestOptions): APIPromise<CallResponse>;
     /**
      * Update metadata and sensitive data storage settings for an existing call.
      *
@@ -29,7 +30,7 @@ export declare class Call extends APIResource {
      * );
      * ```
      */
-    update(callId: string, body: CallUpdateParams, options?: Core.RequestOptions): Core.APIPromise<CallResponse>;
+    update(callID: string, body: CallUpdateParams, options?: RequestOptions): APIPromise<CallResponse>;
     /**
      * Retrieve call details
      *
@@ -38,7 +39,7 @@ export declare class Call extends APIResource {
      * const callResponses = await client.call.list();
      * ```
      */
-    list(body: CallListParams, options?: Core.RequestOptions): Core.APIPromise<CallListResponse>;
+    list(body: CallListParams, options?: RequestOptions): APIPromise<CallListResponse>;
     /**
      * Delete a specific call and its associated data
      *
@@ -49,7 +50,7 @@ export declare class Call extends APIResource {
      * );
      * ```
      */
-    delete(callId: string, options?: Core.RequestOptions): Core.APIPromise<void>;
+    delete(callID: string, options?: RequestOptions): APIPromise<void>;
     /**
      * Create a new outbound phone call
      *
@@ -63,7 +64,7 @@ export declare class Call extends APIResource {
      * );
      * ```
      */
-    createPhoneCall(body: CallCreatePhoneCallParams, options?: Core.RequestOptions): Core.APIPromise<PhoneCallResponse>;
+    createPhoneCall(body: CallCreatePhoneCallParams, options?: RequestOptions): APIPromise<PhoneCallResponse>;
     /**
      * Create a new web call
      *
@@ -74,7 +75,7 @@ export declare class Call extends APIResource {
      * });
      * ```
      */
-    createWebCall(body: CallCreateWebCallParams, options?: Core.RequestOptions): Core.APIPromise<WebCallResponse>;
+    createWebCall(body: CallCreateWebCallParams, options?: RequestOptions): APIPromise<WebCallResponse>;
     /**
      * Register a new phone call for custom telephony
      *
@@ -86,7 +87,7 @@ export declare class Call extends APIResource {
      *   });
      * ```
      */
-    registerPhoneCall(body: CallRegisterPhoneCallParams, options?: Core.RequestOptions): Core.APIPromise<PhoneCallResponse>;
+    registerPhoneCall(body: CallRegisterPhoneCallParams, options?: RequestOptions): APIPromise<PhoneCallResponse>;
 }
 export type CallResponse = WebCallResponse | PhoneCallResponse;
 export interface PhoneCallResponse {
@@ -99,20 +100,17 @@ export interface PhoneCallResponse {
      */
     agent_version: number;
     /**
-     * Unique id of the call. Used to identify in LLM websocket and used to
-     * authenticate in audio websocket.
+     * 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
-     *   hanged up, or call transferred.
-     *
+     *   hung up, or call transferred.
      * - `error`: Call encountered error.
      */
     call_status: 'registered' | 'not_connected' | 'ongoing' | 'ended' | 'error';
@@ -245,7 +243,7 @@ export interface PhoneCallResponse {
      * PII. It precisely captures when (at what utterance, which word) the tool was
      * invoked and what was the result. Available after call ends.
      */
-    scrubbed_transcript_with_tool_calls?: Array<PhoneCallResponse.Utterance | PhoneCallResponse.ToolCallInvocationUtterance | PhoneCallResponse.ToolCallResultUtterance | PhoneCallResponse.DtmfUtterance>;
+    scrubbed_transcript_with_tool_calls?: Array<PhoneCallResponse.Utterance | PhoneCallResponse.ToolCallInvocationUtterance | PhoneCallResponse.ToolCallResultUtterance | PhoneCallResponse.NodeTransitionUtterance | PhoneCallResponse.DtmfUtterance>;
     /**
      * Begin timestamp (milliseconds since epoch) of the call. Available after call
      * starts.
@@ -270,15 +268,20 @@ export interface PhoneCallResponse {
      * precisely captures when (at what utterance, which word) the tool was invoked and
      * what was the result. Available after call ends.
      */
-    transcript_with_tool_calls?: Array<PhoneCallResponse.Utterance | PhoneCallResponse.ToolCallInvocationUtterance | PhoneCallResponse.ToolCallResultUtterance | PhoneCallResponse.DtmfUtterance>;
+    transcript_with_tool_calls?: Array<PhoneCallResponse.Utterance | PhoneCallResponse.ToolCallInvocationUtterance | PhoneCallResponse.ToolCallResultUtterance | PhoneCallResponse.NodeTransitionUtterance | PhoneCallResponse.DtmfUtterance>;
     /**
      * 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", "udp", or "auto".
+     * "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 declare namespace PhoneCallResponse {
     /**
@@ -341,6 +344,10 @@ export declare namespace PhoneCallResponse {
              * 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.
              */
@@ -735,6 +742,11 @@ export declare namespace PhoneCallResponse {
          * Tool call id, globally unique.
          */
         tool_call_id: string;
+        /**
+         * Optional thought signature from Google Gemini thinking models. This is used
+         * internally to maintain reasoning chain in multi-turn function calling.
+         */
+        thought_signature?: string;
     }
     interface ToolCallResultUtterance {
         /**
@@ -742,7 +754,7 @@ export declare namespace PhoneCallResponse {
          */
         content: string;
         /**
-         * This is result of a tool call.
+         * This is the result of a tool call.
          */
         role: 'tool_call_result';
         /**
@@ -750,6 +762,28 @@ export declare namespace PhoneCallResponse {
          */
         tool_call_id: string;
     }
+    interface NodeTransitionUtterance {
+        /**
+         * Former node id
+         */
+        former_node_id: string;
+        /**
+         * Former node name
+         */
+        former_node_name: string;
+        /**
+         * New node id
+         */
+        new_node_id: string;
+        /**
+         * New node name
+         */
+        new_node_name: string;
+        /**
+         * This is result of a node transition
+         */
+        role: 'node_transition';
+    }
     interface DtmfUtterance {
         /**
          * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -757,7 +791,7 @@ export declare namespace PhoneCallResponse {
          */
         digit: string;
         /**
-         * This is user pressed digit from their phone keypad.
+         * Digit pressed by the user from their phone keypad.
          */
         role: 'dtmf';
     }
@@ -856,6 +890,11 @@ export declare namespace PhoneCallResponse {
          * Tool call id, globally unique.
          */
         tool_call_id: string;
+        /**
+         * Optional thought signature from Google Gemini thinking models. This is used
+         * internally to maintain reasoning chain in multi-turn function calling.
+         */
+        thought_signature?: string;
     }
     interface ToolCallResultUtterance {
         /**
@@ -863,7 +902,7 @@ export declare namespace PhoneCallResponse {
          */
         content: string;
         /**
-         * This is result of a tool call.
+         * This is the result of a tool call.
          */
         role: 'tool_call_result';
         /**
@@ -871,6 +910,28 @@ export declare namespace PhoneCallResponse {
          */
         tool_call_id: string;
     }
+    interface NodeTransitionUtterance {
+        /**
+         * Former node id
+         */
+        former_node_id: string;
+        /**
+         * Former node name
+         */
+        former_node_name: string;
+        /**
+         * New node id
+         */
+        new_node_id: string;
+        /**
+         * New node name
+         */
+        new_node_name: string;
+        /**
+         * This is result of a node transition
+         */
+        role: 'node_transition';
+    }
     interface DtmfUtterance {
         /**
          * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -878,7 +939,7 @@ export declare namespace PhoneCallResponse {
          */
         digit: string;
         /**
-         * This is user pressed digit from their phone keypad.
+         * Digit pressed by the user from their phone keypad.
          */
         role: 'dtmf';
     }
@@ -898,20 +959,17 @@ export interface WebCallResponse {
      */
     agent_version: number;
     /**
-     * Unique id of the call. Used to identify in LLM websocket and used to
-     * authenticate in audio websocket.
+     * 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
-     *   hanged up, or call transferred.
-     *
+     *   hung up, or call transferred.
      * - `error`: Call encountered error.
      */
     call_status: 'registered' | 'not_connected' | 'ongoing' | 'ended' | 'error';
@@ -1032,7 +1090,7 @@ export interface WebCallResponse {
      * PII. It precisely captures when (at what utterance, which word) the tool was
      * invoked and what was the result. Available after call ends.
      */
-    scrubbed_transcript_with_tool_calls?: Array<WebCallResponse.Utterance | WebCallResponse.ToolCallInvocationUtterance | WebCallResponse.ToolCallResultUtterance | WebCallResponse.DtmfUtterance>;
+    scrubbed_transcript_with_tool_calls?: Array<WebCallResponse.Utterance | WebCallResponse.ToolCallInvocationUtterance | WebCallResponse.ToolCallResultUtterance | WebCallResponse.NodeTransitionUtterance | WebCallResponse.DtmfUtterance>;
     /**
      * Begin timestamp (milliseconds since epoch) of the call. Available after call
      * starts.
@@ -1052,15 +1110,20 @@ export interface WebCallResponse {
      * precisely captures when (at what utterance, which word) the tool was invoked and
      * what was the result. Available after call ends.
      */
-    transcript_with_tool_calls?: Array<WebCallResponse.Utterance | WebCallResponse.ToolCallInvocationUtterance | WebCallResponse.ToolCallResultUtterance | WebCallResponse.DtmfUtterance>;
+    transcript_with_tool_calls?: Array<WebCallResponse.Utterance | WebCallResponse.ToolCallInvocationUtterance | WebCallResponse.ToolCallResultUtterance | WebCallResponse.NodeTransitionUtterance | WebCallResponse.DtmfUtterance>;
     /**
      * 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", "udp", or "auto".
+     * "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 declare namespace WebCallResponse {
     /**
@@ -1123,6 +1186,10 @@ export declare namespace WebCallResponse {
              * 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.
              */
@@ -1517,6 +1584,11 @@ export declare namespace WebCallResponse {
          * Tool call id, globally unique.
          */
         tool_call_id: string;
+        /**
+         * Optional thought signature from Google Gemini thinking models. This is used
+         * internally to maintain reasoning chain in multi-turn function calling.
+         */
+        thought_signature?: string;
     }
     interface ToolCallResultUtterance {
         /**
@@ -1524,7 +1596,7 @@ export declare namespace WebCallResponse {
          */
         content: string;
         /**
-         * This is result of a tool call.
+         * This is the result of a tool call.
          */
         role: 'tool_call_result';
         /**
@@ -1532,6 +1604,28 @@ export declare namespace WebCallResponse {
          */
         tool_call_id: string;
     }
+    interface NodeTransitionUtterance {
+        /**
+         * Former node id
+         */
+        former_node_id: string;
+        /**
+         * Former node name
+         */
+        former_node_name: string;
+        /**
+         * New node id
+         */
+        new_node_id: string;
+        /**
+         * New node name
+         */
+        new_node_name: string;
+        /**
+         * This is result of a node transition
+         */
+        role: 'node_transition';
+    }
     interface DtmfUtterance {
         /**
          * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -1539,7 +1633,7 @@ export declare namespace WebCallResponse {
          */
         digit: string;
         /**
-         * This is user pressed digit from their phone keypad.
+         * Digit pressed by the user from their phone keypad.
          */
         role: 'dtmf';
     }
@@ -1628,6 +1722,11 @@ export declare namespace WebCallResponse {
          * Tool call id, globally unique.
          */
         tool_call_id: string;
+        /**
+         * Optional thought signature from Google Gemini thinking models. This is used
+         * internally to maintain reasoning chain in multi-turn function calling.
+         */
+        thought_signature?: string;
     }
     interface ToolCallResultUtterance {
         /**
@@ -1635,7 +1734,7 @@ export declare namespace WebCallResponse {
          */
         content: string;
         /**
-         * This is result of a tool call.
+         * This is the result of a tool call.
          */
         role: 'tool_call_result';
         /**
@@ -1643,6 +1742,28 @@ export declare namespace WebCallResponse {
          */
         tool_call_id: string;
     }
+    interface NodeTransitionUtterance {
+        /**
+         * Former node id
+         */
+        former_node_id: string;
+        /**
+         * Former node name
+         */
+        former_node_name: string;
+        /**
+         * New node id
+         */
+        new_node_id: string;
+        /**
+         * New node name
+         */
+        new_node_name: string;
+        /**
+         * This is result of a node transition
+         */
+        role: 'node_transition';
+    }
     interface DtmfUtterance {
         /**
          * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -1650,13 +1771,19 @@ export declare namespace WebCallResponse {
          */
         digit: string;
         /**
-         * This is user pressed digit from their phone keypad.
+         * Digit pressed by the user from their phone keypad.
          */
         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
@@ -1741,7 +1868,18 @@ export declare namespace CallListParams {
          * Only retrieve calls with specific range of duration(s).
          */
         duration_ms?: FilterCriteria.DurationMs;
+        /**
+         * Filter by dynamic variables using dot notation (e.g., `dynamic_variables.name`).
+         * Values are matched exactly as strings.
+         */
+        dynamic_variables?: {
+            [key: string]: Array<string>;
+        };
         e2e_latency_p50?: FilterCriteria.E2ELatencyP50;
+        /**
+         * Only retrieve calls with specific range of end timestamp(s).
+         */
+        end_timestamp?: FilterCriteria.EndTimestamp;
         /**
          * Only retrieve calls with specific from number(s).
          */
@@ -1750,6 +1888,13 @@ export declare namespace CallListParams {
          * Only retrieve calls that are in voicemail or not in voicemail.
          */
         in_voicemail?: Array<boolean>;
+        /**
+         * Filter by metadata fields using dot notation (e.g., `metadata.customer_id`).
+         * Values are matched exactly as strings.
+         */
+        metadata?: {
+            [key: string]: Array<string>;
+        };
         /**
          * Only retrieve calls with specific range of start timestamp(s).
          */
@@ -1779,6 +1924,13 @@ export declare namespace CallListParams {
             lower_threshold?: number;
             upper_threshold?: number;
         }
+        /**
+         * Only retrieve calls with specific range of end timestamp(s).
+         */
+        interface EndTimestamp {
+            lower_threshold?: number;
+            upper_threshold?: number;
+        }
         /**
          * Only retrieve calls with specific range of start timestamp(s).
          */
@@ -1893,24 +2045,18 @@ export declare namespace CallCreatePhoneCallParams {
              *
              * - `coffee-shop`: Coffee shop ambience with people chatting in background.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/coffee-shop.wav)
-             *
              * - `convention-hall`: Convention hall ambience, with some echo and people
              *   chatting in background.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/convention-hall.wav)
-             *
              * - `summer-outdoor`: Summer outdoor ambience with cicada chirping.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/summer-outdoor.wav)
-             *
              * - `mountain-outdoor`: Mountain outdoor ambience with birds singing.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/mountain-outdoor.wav)
-             *
              * - `static-noise`: Constant static noise.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/static-noise.wav)
-             *
              * - `call-center`: Call center work noise.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/call-center.wav)
-             *
-             * Set to `null` to remove ambient sound from this agent.
+             *   Set to `null` to remove ambient sound from this agent.
              */
             ambient_sound?: 'coffee-shop' | 'convention-hall' | 'summer-outdoor' | 'mountain-outdoor' | 'static-noise' | 'call-center' | null;
             /**
@@ -1959,6 +2105,10 @@ export declare namespace CallCreatePhoneCallParams {
              * street, etc.
              */
             boosted_keywords?: Array<string> | null;
+            /**
+             * Custom STT configuration. Only used when stt_mode is set to custom.
+             */
+            custom_stt_config?: Agent.CustomSttConfig;
             /**
              * Granular setting to manage how Retell stores sensitive data (transcripts,
              * recordings, logs, etc.). This replaces the deprecated
@@ -1972,9 +2122,10 @@ export declare namespace CallCreatePhoneCallParams {
              */
             data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only';
             /**
-             * If set, determines what denoising mode to use. Default to noise-cancellation.
+             * If set, determines what denoising mode to use. Use "no-denoise" to bypass all
+             * audio denoising. Default to noise-cancellation.
              */
-            denoising_mode?: 'noise-cancellation' | 'noise-and-background-speech-cancellation';
+            denoising_mode?: 'no-denoise' | 'noise-cancellation' | 'noise-and-background-speech-cancellation';
             /**
              * Controls whether the agent would backchannel (agent interjects the speaker with
              * phrases like "yeah", "uh-huh" to signify interest and engagement). Backchannel
@@ -1982,6 +2133,16 @@ export declare namespace CallCreatePhoneCallParams {
              * will not backchannel.
              */
             enable_backchannel?: boolean;
+            /**
+             * If set to true, will enable dynamic voice speed adjustment based on the user's
+             * speech rate and conversation context. If unset, default value false will apply.
+             */
+            enable_dynamic_voice_speed?: boolean;
+            /**
+             * If set to true, will detect whether the call enters a voicemail. Note that this
+             * feature is only available for phone calls.
+             */
+            enable_voicemail_detection?: boolean;
             /**
              * If users stay silent for a period after agent speech, end the call. The minimum
              * value allowed is 10,000 ms (10 s). By default, this is set to 600000 (10 min).
@@ -1995,6 +2156,11 @@ export declare namespace CallCreatePhoneCallParams {
              * one. Set to null to remove voice fallback for the agent.
              */
             fallback_voice_ids?: Array<string> | null;
+            /**
+             * Configuration for guardrail checks to detect and prevent prohibited topics in
+             * agent output and user input.
+             */
+            guardrail_config?: Agent.GuardrailConfig;
             /**
              * Controls how sensitive the agent is to user interruptions. Value ranging from
              * [0,1]. Lower value means it will take longer / more words for user to interrupt
@@ -2003,13 +2169,24 @@ export declare namespace CallCreatePhoneCallParams {
              * interrupted.
              */
             interruption_sensitivity?: number;
+            /**
+             * Whether the agent is public. When set to true, the agent is available for public
+             * agent preview link.
+             */
+            is_public?: boolean | null;
+            /**
+             * If this option is set, the call will try to detect IVR in the first 3 minutes of
+             * the call. Actions defined will be applied when the IVR is detected. Set this to
+             * null to disable IVR detection.
+             */
+            ivr_option?: Agent.IvrOption | null;
             /**
              * Specifies what language (and dialect) the speech recognition will operate in.
              * For instance, selecting `en-GB` optimizes speech recognition for British
              * English. If unset, will use default value `en-US`. Select `multi` for
-             * multilingual support, currently this supports Spanish and English.
+             * multilingual support.
              */
-            language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'th-TH' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'multi';
+            language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'th-TH' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'lt-LT' | 'lv-LV' | 'cs-CZ' | 'ms-MY' | 'af-ZA' | 'ar-SA' | 'az-AZ' | 'bs-BA' | 'cy-GB' | 'fa-IR' | 'fil-PH' | 'gl-ES' | 'he-IL' | 'hr-HR' | 'hy-AM' | 'is-IS' | 'kk-KZ' | 'kn-IN' | 'mk-MK' | 'mr-IN' | 'ne-NP' | 'sl-SI' | 'sr-RS' | 'sw-KE' | 'ta-IN' | 'ur-IN' | 'yue-CN' | 'uk-UA' | 'multi';
             /**
              * Maximum allowed length for the call, will force end the call if reached. The
              * minimum value allowed is 60,000 ms (1 min), and maximum value allowed is
@@ -2045,7 +2222,7 @@ export declare namespace CallCreatePhoneCallParams {
             /**
              * The model to use for post call analysis. Default to gpt-4.1-mini.
              */
-            post_call_analysis_model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+            post_call_analysis_model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | null;
             /**
              * A list of words / phrases and their pronunciation to be used to guide the audio
              * synthesize for consistent pronunciation. Currently only supported for English &
@@ -2091,28 +2268,37 @@ export declare namespace CallCreatePhoneCallParams {
             signed_url_expiration_ms?: number | null;
             /**
              * If set, determines whether speech to text should focus on latency or accuracy.
-             * Default to fast mode.
+             * Default to fast mode. When set to custom, custom_stt_config must be provided.
              */
-            stt_mode?: 'fast' | 'accurate';
+            stt_mode?: 'fast' | 'accurate' | 'custom';
             user_dtmf_options?: Agent.UserDtmfOptions | null;
+            /**
+             * Optional description of the agent version. Used for your own reference and
+             * documentation.
+             */
+            version_description?: string | null;
             /**
              * If set, determines the vocabulary set to use for transcription. This setting
              * only applies for English agents, for non English agent, this setting is a no-op.
              * Default to general.
              */
             vocab_specialization?: 'general' | 'medical';
+            /**
+             * Controls the emotional tone of the agent's voice. Currently supported for
+             * Cartesia and Minimax TTS providers. If unset, no emotion will be used.
+             */
+            voice_emotion?: 'calm' | 'sympathetic' | 'happy' | 'sad' | 'angry' | 'fearful' | 'surprised' | null;
             /**
              * Unique voice id used for the agent. Find list of available voices and their
              * preview in Dashboard.
              */
             voice_id?: string;
             /**
-             * Optionally set the voice model used for the selected voice. Currently only
-             * elevenlab voices have voice model selections. Set to null to remove voice model
-             * selection, and default ones will apply. Check out the dashboard for details on
-             * each voice model.
+             * Select the voice model used for the selected voice. Each provider has a set of
+             * 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' | 'tts-1' | 'gpt-4o-mini-tts' | null;
+            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'sonic-2' | 'sonic-3' | 'sonic-3-latest' | 'sonic-turbo' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 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
@@ -2126,6 +2312,19 @@ export declare namespace CallCreatePhoneCallParams {
              * apply.
              */
             voice_temperature?: number;
+            /**
+             * Configures when to stop running voicemail detection, as it becomes unlikely to
+             * hit voicemail after a couple minutes, and keep running it will only have
+             * negative impact. The minimum value allowed is 5,000 ms (5 s), and maximum value
+             * allowed is 180,000 (3 minutes). By default, this is set to 30,000 (30 s).
+             */
+            voicemail_detection_timeout_ms?: number;
+            /**
+             * The message to be played when the call enters a voicemail. Note that this
+             * feature is only available for phone calls. If you want to hangup after hitting
+             * voicemail, set this to empty string.
+             */
+            voicemail_message?: string;
             /**
              * If this option is set, the call will try to detect voicemail in the first 3
              * minutes of the call. Actions defined (hangup, or leave a message) will be
@@ -2139,6 +2338,11 @@ export declare namespace CallCreatePhoneCallParams {
              * If unset, default value 1 will apply.
              */
             volume?: number;
+            /**
+             * Which webhook events this agent should receive. If not set, defaults to
+             * call_started, call_ended, call_analyzed.
+             */
+            webhook_events?: Array<'call_started' | 'call_ended' | 'call_analyzed' | 'transcript_updated' | 'transfer_started' | 'transfer_bridged' | 'transfer_cancelled' | 'transfer_ended'> | null;
             /**
              * The timeout for the webhook in milliseconds. If not set, default value of 10000
              * will apply.
@@ -2153,6 +2357,49 @@ export declare namespace CallCreatePhoneCallParams {
             webhook_url?: string | null;
         }
         namespace Agent {
+            /**
+             * Custom STT configuration. Only used when stt_mode is set to custom.
+             */
+            interface CustomSttConfig {
+                /**
+                 * Endpointing timeout in milliseconds. Minimum is 100 for azure, 10 for deepgram.
+                 */
+                endpointing_ms: number;
+                /**
+                 * The STT provider to use.
+                 */
+                provider: 'azure' | 'deepgram';
+            }
+            /**
+             * Configuration for guardrail checks to detect and prevent prohibited topics in
+             * agent output and user input.
+             */
+            interface GuardrailConfig {
+                /**
+                 * Selected prohibited user topic categories to check. When user messages contain
+                 * these topics, the agent will respond with a placeholder message instead of
+                 * processing the request.
+                 */
+                input_topics?: Array<'platform_integrity_jailbreaking'> | null;
+                /**
+                 * Selected prohibited agent topic categories to check. When agent messages contain
+                 * these topics, they will be replaced with a placeholder message.
+                 */
+                output_topics?: Array<'harassment' | 'self_harm' | 'sexual_exploitation' | 'violence' | 'defense_and_national_security' | 'illicit_and_harmful_activity' | 'gambling' | 'regulated_professional_advice' | 'child_safety_and_exploitation'> | null;
+            }
+            /**
+             * If this option is set, the call will try to detect IVR in the first 3 minutes of
+             * the call. Actions defined will be applied when the IVR is detected. Set this to
+             * null to disable IVR detection.
+             */
+            interface IvrOption {
+                action: IvrOption.Action;
+            }
+            namespace IvrOption {
+                interface Action {
+                    type: 'hangup';
+                }
+            }
             /**
              * Configuration for PII scrubbing from transcripts and recordings.
              */
@@ -2160,7 +2407,7 @@ export declare namespace CallCreatePhoneCallParams {
                 /**
                  * List of PII categories to scrub from transcripts and recordings.
                  */
-                categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth'>;
+                categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth' | 'customer_account_number'>;
                 /**
                  * The processing mode for PII scrubbing. Currently only post-call is supported.
                  */
@@ -2291,7 +2538,7 @@ export declare namespace CallCreatePhoneCallParams {
                 digit_limit?: number | null;
                 /**
                  * A single key that signals the end of DTMF input. Acceptable values include any
-                 * digit (0–9), the pound/hash symbol (#), or the asterisk (\*).
+                 * digit (0-9), the pound/hash symbol (#), or the asterisk (\*).
                  */
                 termination_key?: string | null;
                 /**
@@ -2307,7 +2554,7 @@ export declare namespace CallCreatePhoneCallParams {
              * detection.
              */
             interface VoicemailOption {
-                action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup;
+                action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup | VoicemailOption.VoicemailActionBridgeTransfer;
             }
             namespace VoicemailOption {
                 interface VoicemailActionPrompt {
@@ -2328,6 +2575,9 @@ export declare namespace CallCreatePhoneCallParams {
                 interface VoicemailActionHangup {
                     type: 'hangup';
                 }
+                interface VoicemailActionBridgeTransfer {
+                    type: 'bridge_transfer';
+                }
             }
         }
         /**
@@ -2392,7 +2642,7 @@ export declare namespace CallCreatePhoneCallParams {
                 /**
                  * The LLM model to use
                  */
-                model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
+                model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
                 /**
                  * Type of model choice
                  */
@@ -2434,7 +2684,7 @@ export declare namespace CallCreatePhoneCallParams {
             /**
              * Select the underlying text LLM. If not set, would default to gpt-4.1.
              */
-            model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+            model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | null;
             /**
              * If set to true, will use high priority pool with more dedicated resource to
              * ensure lower and more consistent latency, default to false. This feature usually
@@ -2452,7 +2702,7 @@ export declare namespace CallCreatePhoneCallParams {
              * Select the underlying speech to speech model. Can only set this or model, not
              * both.
              */
-            s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | null;
+            s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
             /**
              * The speaker who starts the conversation. Required. Must be either 'user' or
              * 'agent'.
@@ -2561,24 +2811,18 @@ export declare namespace CallCreateWebCallParams {
              *
              * - `coffee-shop`: Coffee shop ambience with people chatting in background.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/coffee-shop.wav)
-             *
              * - `convention-hall`: Convention hall ambience, with some echo and people
              *   chatting in background.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/convention-hall.wav)
-             *
              * - `summer-outdoor`: Summer outdoor ambience with cicada chirping.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/summer-outdoor.wav)
-             *
              * - `mountain-outdoor`: Mountain outdoor ambience with birds singing.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/mountain-outdoor.wav)
-             *
              * - `static-noise`: Constant static noise.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/static-noise.wav)
-             *
              * - `call-center`: Call center work noise.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/call-center.wav)
-             *
-             * Set to `null` to remove ambient sound from this agent.
+             *   Set to `null` to remove ambient sound from this agent.
              */
             ambient_sound?: 'coffee-shop' | 'convention-hall' | 'summer-outdoor' | 'mountain-outdoor' | 'static-noise' | 'call-center' | null;
             /**
@@ -2627,6 +2871,10 @@ export declare namespace CallCreateWebCallParams {
              * street, etc.
              */
             boosted_keywords?: Array<string> | null;
+            /**
+             * Custom STT configuration. Only used when stt_mode is set to custom.
+             */
+            custom_stt_config?: Agent.CustomSttConfig;
             /**
              * Granular setting to manage how Retell stores sensitive data (transcripts,
              * recordings, logs, etc.). This replaces the deprecated
@@ -2640,9 +2888,10 @@ export declare namespace CallCreateWebCallParams {
              */
             data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only';
             /**
-             * If set, determines what denoising mode to use. Default to noise-cancellation.
+             * If set, determines what denoising mode to use. Use "no-denoise" to bypass all
+             * audio denoising. Default to noise-cancellation.
              */
-            denoising_mode?: 'noise-cancellation' | 'noise-and-background-speech-cancellation';
+            denoising_mode?: 'no-denoise' | 'noise-cancellation' | 'noise-and-background-speech-cancellation';
             /**
              * Controls whether the agent would backchannel (agent interjects the speaker with
              * phrases like "yeah", "uh-huh" to signify interest and engagement). Backchannel
@@ -2650,6 +2899,16 @@ export declare namespace CallCreateWebCallParams {
              * will not backchannel.
              */
             enable_backchannel?: boolean;
+            /**
+             * If set to true, will enable dynamic voice speed adjustment based on the user's
+             * speech rate and conversation context. If unset, default value false will apply.
+             */
+            enable_dynamic_voice_speed?: boolean;
+            /**
+             * If set to true, will detect whether the call enters a voicemail. Note that this
+             * feature is only available for phone calls.
+             */
+            enable_voicemail_detection?: boolean;
             /**
              * If users stay silent for a period after agent speech, end the call. The minimum
              * value allowed is 10,000 ms (10 s). By default, this is set to 600000 (10 min).
@@ -2663,6 +2922,11 @@ export declare namespace CallCreateWebCallParams {
              * one. Set to null to remove voice fallback for the agent.
              */
             fallback_voice_ids?: Array<string> | null;
+            /**
+             * Configuration for guardrail checks to detect and prevent prohibited topics in
+             * agent output and user input.
+             */
+            guardrail_config?: Agent.GuardrailConfig;
             /**
              * Controls how sensitive the agent is to user interruptions. Value ranging from
              * [0,1]. Lower value means it will take longer / more words for user to interrupt
@@ -2671,13 +2935,24 @@ export declare namespace CallCreateWebCallParams {
              * interrupted.
              */
             interruption_sensitivity?: number;
+            /**
+             * Whether the agent is public. When set to true, the agent is available for public
+             * agent preview link.
+             */
+            is_public?: boolean | null;
+            /**
+             * If this option is set, the call will try to detect IVR in the first 3 minutes of
+             * the call. Actions defined will be applied when the IVR is detected. Set this to
+             * null to disable IVR detection.
+             */
+            ivr_option?: Agent.IvrOption | null;
             /**
              * Specifies what language (and dialect) the speech recognition will operate in.
              * For instance, selecting `en-GB` optimizes speech recognition for British
              * English. If unset, will use default value `en-US`. Select `multi` for
-             * multilingual support, currently this supports Spanish and English.
+             * multilingual support.
              */
-            language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'th-TH' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'multi';
+            language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'th-TH' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'lt-LT' | 'lv-LV' | 'cs-CZ' | 'ms-MY' | 'af-ZA' | 'ar-SA' | 'az-AZ' | 'bs-BA' | 'cy-GB' | 'fa-IR' | 'fil-PH' | 'gl-ES' | 'he-IL' | 'hr-HR' | 'hy-AM' | 'is-IS' | 'kk-KZ' | 'kn-IN' | 'mk-MK' | 'mr-IN' | 'ne-NP' | 'sl-SI' | 'sr-RS' | 'sw-KE' | 'ta-IN' | 'ur-IN' | 'yue-CN' | 'uk-UA' | 'multi';
             /**
              * Maximum allowed length for the call, will force end the call if reached. The
              * minimum value allowed is 60,000 ms (1 min), and maximum value allowed is
@@ -2713,7 +2988,7 @@ export declare namespace CallCreateWebCallParams {
             /**
              * The model to use for post call analysis. Default to gpt-4.1-mini.
              */
-            post_call_analysis_model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+            post_call_analysis_model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | null;
             /**
              * A list of words / phrases and their pronunciation to be used to guide the audio
              * synthesize for consistent pronunciation. Currently only supported for English &
@@ -2759,28 +3034,37 @@ export declare namespace CallCreateWebCallParams {
             signed_url_expiration_ms?: number | null;
             /**
              * If set, determines whether speech to text should focus on latency or accuracy.
-             * Default to fast mode.
+             * Default to fast mode. When set to custom, custom_stt_config must be provided.
              */
-            stt_mode?: 'fast' | 'accurate';
+            stt_mode?: 'fast' | 'accurate' | 'custom';
             user_dtmf_options?: Agent.UserDtmfOptions | null;
+            /**
+             * Optional description of the agent version. Used for your own reference and
+             * documentation.
+             */
+            version_description?: string | null;
             /**
              * If set, determines the vocabulary set to use for transcription. This setting
              * only applies for English agents, for non English agent, this setting is a no-op.
              * Default to general.
              */
             vocab_specialization?: 'general' | 'medical';
+            /**
+             * Controls the emotional tone of the agent's voice. Currently supported for
+             * Cartesia and Minimax TTS providers. If unset, no emotion will be used.
+             */
+            voice_emotion?: 'calm' | 'sympathetic' | 'happy' | 'sad' | 'angry' | 'fearful' | 'surprised' | null;
             /**
              * Unique voice id used for the agent. Find list of available voices and their
              * preview in Dashboard.
              */
             voice_id?: string;
             /**
-             * Optionally set the voice model used for the selected voice. Currently only
-             * elevenlab voices have voice model selections. Set to null to remove voice model
-             * selection, and default ones will apply. Check out the dashboard for details on
-             * each voice model.
+             * Select the voice model used for the selected voice. Each provider has a set of
+             * 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' | 'tts-1' | 'gpt-4o-mini-tts' | null;
+            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'sonic-2' | 'sonic-3' | 'sonic-3-latest' | 'sonic-turbo' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 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
@@ -2794,6 +3078,19 @@ export declare namespace CallCreateWebCallParams {
              * apply.
              */
             voice_temperature?: number;
+            /**
+             * Configures when to stop running voicemail detection, as it becomes unlikely to
+             * hit voicemail after a couple minutes, and keep running it will only have
+             * negative impact. The minimum value allowed is 5,000 ms (5 s), and maximum value
+             * allowed is 180,000 (3 minutes). By default, this is set to 30,000 (30 s).
+             */
+            voicemail_detection_timeout_ms?: number;
+            /**
+             * The message to be played when the call enters a voicemail. Note that this
+             * feature is only available for phone calls. If you want to hangup after hitting
+             * voicemail, set this to empty string.
+             */
+            voicemail_message?: string;
             /**
              * If this option is set, the call will try to detect voicemail in the first 3
              * minutes of the call. Actions defined (hangup, or leave a message) will be
@@ -2807,6 +3104,11 @@ export declare namespace CallCreateWebCallParams {
              * If unset, default value 1 will apply.
              */
             volume?: number;
+            /**
+             * Which webhook events this agent should receive. If not set, defaults to
+             * call_started, call_ended, call_analyzed.
+             */
+            webhook_events?: Array<'call_started' | 'call_ended' | 'call_analyzed' | 'transcript_updated' | 'transfer_started' | 'transfer_bridged' | 'transfer_cancelled' | 'transfer_ended'> | null;
             /**
              * The timeout for the webhook in milliseconds. If not set, default value of 10000
              * will apply.
@@ -2821,6 +3123,49 @@ export declare namespace CallCreateWebCallParams {
             webhook_url?: string | null;
         }
         namespace Agent {
+            /**
+             * Custom STT configuration. Only used when stt_mode is set to custom.
+             */
+            interface CustomSttConfig {
+                /**
+                 * Endpointing timeout in milliseconds. Minimum is 100 for azure, 10 for deepgram.
+                 */
+                endpointing_ms: number;
+                /**
+                 * The STT provider to use.
+                 */
+                provider: 'azure' | 'deepgram';
+            }
+            /**
+             * Configuration for guardrail checks to detect and prevent prohibited topics in
+             * agent output and user input.
+             */
+            interface GuardrailConfig {
+                /**
+                 * Selected prohibited user topic categories to check. When user messages contain
+                 * these topics, the agent will respond with a placeholder message instead of
+                 * processing the request.
+                 */
+                input_topics?: Array<'platform_integrity_jailbreaking'> | null;
+                /**
+                 * Selected prohibited agent topic categories to check. When agent messages contain
+                 * these topics, they will be replaced with a placeholder message.
+                 */
+                output_topics?: Array<'harassment' | 'self_harm' | 'sexual_exploitation' | 'violence' | 'defense_and_national_security' | 'illicit_and_harmful_activity' | 'gambling' | 'regulated_professional_advice' | 'child_safety_and_exploitation'> | null;
+            }
+            /**
+             * If this option is set, the call will try to detect IVR in the first 3 minutes of
+             * the call. Actions defined will be applied when the IVR is detected. Set this to
+             * null to disable IVR detection.
+             */
+            interface IvrOption {
+                action: IvrOption.Action;
+            }
+            namespace IvrOption {
+                interface Action {
+                    type: 'hangup';
+                }
+            }
             /**
              * Configuration for PII scrubbing from transcripts and recordings.
              */
@@ -2828,7 +3173,7 @@ export declare namespace CallCreateWebCallParams {
                 /**
                  * List of PII categories to scrub from transcripts and recordings.
                  */
-                categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth'>;
+                categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth' | 'customer_account_number'>;
                 /**
                  * The processing mode for PII scrubbing. Currently only post-call is supported.
                  */
@@ -2959,7 +3304,7 @@ export declare namespace CallCreateWebCallParams {
                 digit_limit?: number | null;
                 /**
                  * A single key that signals the end of DTMF input. Acceptable values include any
-                 * digit (0–9), the pound/hash symbol (#), or the asterisk (\*).
+                 * digit (0-9), the pound/hash symbol (#), or the asterisk (\*).
                  */
                 termination_key?: string | null;
                 /**
@@ -2975,7 +3320,7 @@ export declare namespace CallCreateWebCallParams {
              * detection.
              */
             interface VoicemailOption {
-                action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup;
+                action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup | VoicemailOption.VoicemailActionBridgeTransfer;
             }
             namespace VoicemailOption {
                 interface VoicemailActionPrompt {
@@ -2996,6 +3341,9 @@ export declare namespace CallCreateWebCallParams {
                 interface VoicemailActionHangup {
                     type: 'hangup';
                 }
+                interface VoicemailActionBridgeTransfer {
+                    type: 'bridge_transfer';
+                }
             }
         }
         /**
@@ -3060,7 +3408,7 @@ export declare namespace CallCreateWebCallParams {
                 /**
                  * The LLM model to use
                  */
-                model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
+                model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
                 /**
                  * Type of model choice
                  */
@@ -3102,7 +3450,7 @@ export declare namespace CallCreateWebCallParams {
             /**
              * Select the underlying text LLM. If not set, would default to gpt-4.1.
              */
-            model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+            model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | null;
             /**
              * If set to true, will use high priority pool with more dedicated resource to
              * ensure lower and more consistent latency, default to false. This feature usually
@@ -3120,7 +3468,7 @@ export declare namespace CallCreateWebCallParams {
              * Select the underlying speech to speech model. Can only set this or model, not
              * both.
              */
-            s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | null;
+            s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
             /**
              * The speaker who starts the conversation. Required. Must be either 'user' or
              * 'agent'.
@@ -3240,24 +3588,18 @@ export declare namespace CallRegisterPhoneCallParams {
              *
              * - `coffee-shop`: Coffee shop ambience with people chatting in background.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/coffee-shop.wav)
-             *
              * - `convention-hall`: Convention hall ambience, with some echo and people
              *   chatting in background.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/convention-hall.wav)
-             *
              * - `summer-outdoor`: Summer outdoor ambience with cicada chirping.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/summer-outdoor.wav)
-             *
              * - `mountain-outdoor`: Mountain outdoor ambience with birds singing.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/mountain-outdoor.wav)
-             *
              * - `static-noise`: Constant static noise.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/static-noise.wav)
-             *
              * - `call-center`: Call center work noise.
              *   [Listen to Ambience](https://retell-utils-public.s3.us-west-2.amazonaws.com/call-center.wav)
-             *
-             * Set to `null` to remove ambient sound from this agent.
+             *   Set to `null` to remove ambient sound from this agent.
              */
             ambient_sound?: 'coffee-shop' | 'convention-hall' | 'summer-outdoor' | 'mountain-outdoor' | 'static-noise' | 'call-center' | null;
             /**
@@ -3306,6 +3648,10 @@ export declare namespace CallRegisterPhoneCallParams {
              * street, etc.
              */
             boosted_keywords?: Array<string> | null;
+            /**
+             * Custom STT configuration. Only used when stt_mode is set to custom.
+             */
+            custom_stt_config?: Agent.CustomSttConfig;
             /**
              * Granular setting to manage how Retell stores sensitive data (transcripts,
              * recordings, logs, etc.). This replaces the deprecated
@@ -3319,9 +3665,10 @@ export declare namespace CallRegisterPhoneCallParams {
              */
             data_storage_setting?: 'everything' | 'everything_except_pii' | 'basic_attributes_only';
             /**
-             * If set, determines what denoising mode to use. Default to noise-cancellation.
+             * If set, determines what denoising mode to use. Use "no-denoise" to bypass all
+             * audio denoising. Default to noise-cancellation.
              */
-            denoising_mode?: 'noise-cancellation' | 'noise-and-background-speech-cancellation';
+            denoising_mode?: 'no-denoise' | 'noise-cancellation' | 'noise-and-background-speech-cancellation';
             /**
              * Controls whether the agent would backchannel (agent interjects the speaker with
              * phrases like "yeah", "uh-huh" to signify interest and engagement). Backchannel
@@ -3329,6 +3676,16 @@ export declare namespace CallRegisterPhoneCallParams {
              * will not backchannel.
              */
             enable_backchannel?: boolean;
+            /**
+             * If set to true, will enable dynamic voice speed adjustment based on the user's
+             * speech rate and conversation context. If unset, default value false will apply.
+             */
+            enable_dynamic_voice_speed?: boolean;
+            /**
+             * If set to true, will detect whether the call enters a voicemail. Note that this
+             * feature is only available for phone calls.
+             */
+            enable_voicemail_detection?: boolean;
             /**
              * If users stay silent for a period after agent speech, end the call. The minimum
              * value allowed is 10,000 ms (10 s). By default, this is set to 600000 (10 min).
@@ -3342,6 +3699,11 @@ export declare namespace CallRegisterPhoneCallParams {
              * one. Set to null to remove voice fallback for the agent.
              */
             fallback_voice_ids?: Array<string> | null;
+            /**
+             * Configuration for guardrail checks to detect and prevent prohibited topics in
+             * agent output and user input.
+             */
+            guardrail_config?: Agent.GuardrailConfig;
             /**
              * Controls how sensitive the agent is to user interruptions. Value ranging from
              * [0,1]. Lower value means it will take longer / more words for user to interrupt
@@ -3350,13 +3712,24 @@ export declare namespace CallRegisterPhoneCallParams {
              * interrupted.
              */
             interruption_sensitivity?: number;
+            /**
+             * Whether the agent is public. When set to true, the agent is available for public
+             * agent preview link.
+             */
+            is_public?: boolean | null;
+            /**
+             * If this option is set, the call will try to detect IVR in the first 3 minutes of
+             * the call. Actions defined will be applied when the IVR is detected. Set this to
+             * null to disable IVR detection.
+             */
+            ivr_option?: Agent.IvrOption | null;
             /**
              * Specifies what language (and dialect) the speech recognition will operate in.
              * For instance, selecting `en-GB` optimizes speech recognition for British
              * English. If unset, will use default value `en-US`. Select `multi` for
-             * multilingual support, currently this supports Spanish and English.
+             * multilingual support.
              */
-            language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'th-TH' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'multi';
+            language?: 'en-US' | 'en-IN' | 'en-GB' | 'en-AU' | 'en-NZ' | 'de-DE' | 'es-ES' | 'es-419' | 'hi-IN' | 'fr-FR' | 'fr-CA' | 'ja-JP' | 'pt-PT' | 'pt-BR' | 'zh-CN' | 'ru-RU' | 'it-IT' | 'ko-KR' | 'nl-NL' | 'nl-BE' | 'pl-PL' | 'tr-TR' | 'vi-VN' | 'ro-RO' | 'bg-BG' | 'ca-ES' | 'th-TH' | 'da-DK' | 'fi-FI' | 'el-GR' | 'hu-HU' | 'id-ID' | 'no-NO' | 'sk-SK' | 'sv-SE' | 'lt-LT' | 'lv-LV' | 'cs-CZ' | 'ms-MY' | 'af-ZA' | 'ar-SA' | 'az-AZ' | 'bs-BA' | 'cy-GB' | 'fa-IR' | 'fil-PH' | 'gl-ES' | 'he-IL' | 'hr-HR' | 'hy-AM' | 'is-IS' | 'kk-KZ' | 'kn-IN' | 'mk-MK' | 'mr-IN' | 'ne-NP' | 'sl-SI' | 'sr-RS' | 'sw-KE' | 'ta-IN' | 'ur-IN' | 'yue-CN' | 'uk-UA' | 'multi';
             /**
              * Maximum allowed length for the call, will force end the call if reached. The
              * minimum value allowed is 60,000 ms (1 min), and maximum value allowed is
@@ -3392,7 +3765,7 @@ export declare namespace CallRegisterPhoneCallParams {
             /**
              * The model to use for post call analysis. Default to gpt-4.1-mini.
              */
-            post_call_analysis_model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+            post_call_analysis_model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | null;
             /**
              * A list of words / phrases and their pronunciation to be used to guide the audio
              * synthesize for consistent pronunciation. Currently only supported for English &
@@ -3438,28 +3811,37 @@ export declare namespace CallRegisterPhoneCallParams {
             signed_url_expiration_ms?: number | null;
             /**
              * If set, determines whether speech to text should focus on latency or accuracy.
-             * Default to fast mode.
+             * Default to fast mode. When set to custom, custom_stt_config must be provided.
              */
-            stt_mode?: 'fast' | 'accurate';
+            stt_mode?: 'fast' | 'accurate' | 'custom';
             user_dtmf_options?: Agent.UserDtmfOptions | null;
+            /**
+             * Optional description of the agent version. Used for your own reference and
+             * documentation.
+             */
+            version_description?: string | null;
             /**
              * If set, determines the vocabulary set to use for transcription. This setting
              * only applies for English agents, for non English agent, this setting is a no-op.
              * Default to general.
              */
             vocab_specialization?: 'general' | 'medical';
+            /**
+             * Controls the emotional tone of the agent's voice. Currently supported for
+             * Cartesia and Minimax TTS providers. If unset, no emotion will be used.
+             */
+            voice_emotion?: 'calm' | 'sympathetic' | 'happy' | 'sad' | 'angry' | 'fearful' | 'surprised' | null;
             /**
              * Unique voice id used for the agent. Find list of available voices and their
              * preview in Dashboard.
              */
             voice_id?: string;
             /**
-             * Optionally set the voice model used for the selected voice. Currently only
-             * elevenlab voices have voice model selections. Set to null to remove voice model
-             * selection, and default ones will apply. Check out the dashboard for details on
-             * each voice model.
+             * Select the voice model used for the selected voice. Each provider has a set of
+             * 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' | 'tts-1' | 'gpt-4o-mini-tts' | null;
+            voice_model?: 'eleven_turbo_v2' | 'eleven_flash_v2' | 'eleven_turbo_v2_5' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'sonic-2' | 'sonic-3' | 'sonic-3-latest' | 'sonic-turbo' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 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
@@ -3473,6 +3855,19 @@ export declare namespace CallRegisterPhoneCallParams {
              * apply.
              */
             voice_temperature?: number;
+            /**
+             * Configures when to stop running voicemail detection, as it becomes unlikely to
+             * hit voicemail after a couple minutes, and keep running it will only have
+             * negative impact. The minimum value allowed is 5,000 ms (5 s), and maximum value
+             * allowed is 180,000 (3 minutes). By default, this is set to 30,000 (30 s).
+             */
+            voicemail_detection_timeout_ms?: number;
+            /**
+             * The message to be played when the call enters a voicemail. Note that this
+             * feature is only available for phone calls. If you want to hangup after hitting
+             * voicemail, set this to empty string.
+             */
+            voicemail_message?: string;
             /**
              * If this option is set, the call will try to detect voicemail in the first 3
              * minutes of the call. Actions defined (hangup, or leave a message) will be
@@ -3486,6 +3881,11 @@ export declare namespace CallRegisterPhoneCallParams {
              * If unset, default value 1 will apply.
              */
             volume?: number;
+            /**
+             * Which webhook events this agent should receive. If not set, defaults to
+             * call_started, call_ended, call_analyzed.
+             */
+            webhook_events?: Array<'call_started' | 'call_ended' | 'call_analyzed' | 'transcript_updated' | 'transfer_started' | 'transfer_bridged' | 'transfer_cancelled' | 'transfer_ended'> | null;
             /**
              * The timeout for the webhook in milliseconds. If not set, default value of 10000
              * will apply.
@@ -3500,6 +3900,49 @@ export declare namespace CallRegisterPhoneCallParams {
             webhook_url?: string | null;
         }
         namespace Agent {
+            /**
+             * Custom STT configuration. Only used when stt_mode is set to custom.
+             */
+            interface CustomSttConfig {
+                /**
+                 * Endpointing timeout in milliseconds. Minimum is 100 for azure, 10 for deepgram.
+                 */
+                endpointing_ms: number;
+                /**
+                 * The STT provider to use.
+                 */
+                provider: 'azure' | 'deepgram';
+            }
+            /**
+             * Configuration for guardrail checks to detect and prevent prohibited topics in
+             * agent output and user input.
+             */
+            interface GuardrailConfig {
+                /**
+                 * Selected prohibited user topic categories to check. When user messages contain
+                 * these topics, the agent will respond with a placeholder message instead of
+                 * processing the request.
+                 */
+                input_topics?: Array<'platform_integrity_jailbreaking'> | null;
+                /**
+                 * Selected prohibited agent topic categories to check. When agent messages contain
+                 * these topics, they will be replaced with a placeholder message.
+                 */
+                output_topics?: Array<'harassment' | 'self_harm' | 'sexual_exploitation' | 'violence' | 'defense_and_national_security' | 'illicit_and_harmful_activity' | 'gambling' | 'regulated_professional_advice' | 'child_safety_and_exploitation'> | null;
+            }
+            /**
+             * If this option is set, the call will try to detect IVR in the first 3 minutes of
+             * the call. Actions defined will be applied when the IVR is detected. Set this to
+             * null to disable IVR detection.
+             */
+            interface IvrOption {
+                action: IvrOption.Action;
+            }
+            namespace IvrOption {
+                interface Action {
+                    type: 'hangup';
+                }
+            }
             /**
              * Configuration for PII scrubbing from transcripts and recordings.
              */
@@ -3507,7 +3950,7 @@ export declare namespace CallRegisterPhoneCallParams {
                 /**
                  * List of PII categories to scrub from transcripts and recordings.
                  */
-                categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth'>;
+                categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth' | 'customer_account_number'>;
                 /**
                  * The processing mode for PII scrubbing. Currently only post-call is supported.
                  */
@@ -3638,7 +4081,7 @@ export declare namespace CallRegisterPhoneCallParams {
                 digit_limit?: number | null;
                 /**
                  * A single key that signals the end of DTMF input. Acceptable values include any
-                 * digit (0–9), the pound/hash symbol (#), or the asterisk (\*).
+                 * digit (0-9), the pound/hash symbol (#), or the asterisk (\*).
                  */
                 termination_key?: string | null;
                 /**
@@ -3654,7 +4097,7 @@ export declare namespace CallRegisterPhoneCallParams {
              * detection.
              */
             interface VoicemailOption {
-                action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup;
+                action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup | VoicemailOption.VoicemailActionBridgeTransfer;
             }
             namespace VoicemailOption {
                 interface VoicemailActionPrompt {
@@ -3675,6 +4118,9 @@ export declare namespace CallRegisterPhoneCallParams {
                 interface VoicemailActionHangup {
                     type: 'hangup';
                 }
+                interface VoicemailActionBridgeTransfer {
+                    type: 'bridge_transfer';
+                }
             }
         }
         /**
@@ -3739,7 +4185,7 @@ export declare namespace CallRegisterPhoneCallParams {
                 /**
                  * The LLM model to use
                  */
-                model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite';
+                model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
                 /**
                  * Type of model choice
                  */
@@ -3781,7 +4227,7 @@ export declare namespace CallRegisterPhoneCallParams {
             /**
              * Select the underlying text LLM. If not set, would default to gpt-4.1.
              */
-            model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+            model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash' | null;
             /**
              * If set to true, will use high priority pool with more dedicated resource to
              * ensure lower and more consistent latency, default to false. This feature usually
@@ -3799,7 +4245,7 @@ export declare namespace CallRegisterPhoneCallParams {
              * Select the underlying speech to speech model. Can only set this or model, not
              * both.
              */
-            s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | null;
+            s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | 'gpt-realtime-mini' | null;
             /**
              * The speaker who starts the conversation. Required. Must be either 'user' or
              * 'agent'.