retell-sdk 4.65.0 → 5.0.0

package/src/resources/call.ts

@@ -1,7 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../resource';
-import * as Core from '../core';
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
 
 export class Call extends APIResource {
   /**
@@ -14,8 +17,8 @@ export class Call extends APIResource {
    * );
    * ```
    */
-  retrieve(callId: string, options?: Core.RequestOptions): Core.APIPromise<CallResponse> {
-    return this._client.get(`/v2/get-call/${callId}`, options);
+  retrieve(callID: string, options?: RequestOptions): APIPromise<CallResponse> {
+    return this._client.get(path`/v2/get-call/${callID}`, options);
   }
 
   /**
@@ -35,12 +38,8 @@ export class Call extends APIResource {
    * );
    * ```
    */
-  update(
-    callId: string,
-    body: CallUpdateParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<CallResponse> {
-    return this._client.patch(`/v2/update-call/${callId}`, { body, ...options });
+  update(callID: string, body: CallUpdateParams, options?: RequestOptions): APIPromise<CallResponse> {
+    return this._client.patch(path`/v2/update-call/${callID}`, { body, ...options });
   }
 
   /**
@@ -51,8 +50,12 @@ export class Call extends APIResource {
    * const callResponses = await client.call.list();
    * ```
    */
-  list(body: CallListParams, options?: Core.RequestOptions): Core.APIPromise<CallListResponse> {
-    return this._client.post('/v2/list-calls', { body, ...options });
+  list(body: CallListParams, options?: RequestOptions): APIPromise<CallListResponse> {
+    return this._client.post('/v2/list-calls', {
+      body,
+      timeout: (this._client as any)._options.timeout ?? 300000,
+      ...options,
+    });
   }
 
   /**
@@ -65,10 +68,10 @@ export class Call extends APIResource {
    * );
    * ```
    */
-  delete(callId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
-    return this._client.delete(`/v2/delete-call/${callId}`, {
+  delete(callID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v2/delete-call/${callID}`, {
       ...options,
-      headers: { Accept: '*/*', ...options?.headers },
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
@@ -85,11 +88,12 @@ export class Call extends APIResource {
    * );
    * ```
    */
-  createPhoneCall(
-    body: CallCreatePhoneCallParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<PhoneCallResponse> {
-    return this._client.post('/v2/create-phone-call', { body, ...options });
+  createPhoneCall(body: CallCreatePhoneCallParams, options?: RequestOptions): APIPromise<PhoneCallResponse> {
+    return this._client.post('/v2/create-phone-call', {
+      body,
+      timeout: (this._client as any)._options.timeout ?? 120000,
+      ...options,
+    });
   }
 
   /**
@@ -102,10 +106,7 @@ export class Call extends APIResource {
    * });
    * ```
    */
-  createWebCall(
-    body: CallCreateWebCallParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<WebCallResponse> {
+  createWebCall(body: CallCreateWebCallParams, options?: RequestOptions): APIPromise<WebCallResponse> {
     return this._client.post('/v2/create-web-call', { body, ...options });
   }
 
@@ -122,8 +123,8 @@ export class Call extends APIResource {
    */
   registerPhoneCall(
     body: CallRegisterPhoneCallParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<PhoneCallResponse> {
+    options?: RequestOptions,
+  ): APIPromise<PhoneCallResponse> {
     return this._client.post('/v2/register-phone-call', { body, ...options });
   }
 }
@@ -142,8 +143,8 @@ 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;
 
@@ -151,12 +152,9 @@ export interface PhoneCallResponse {
    * 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';
@@ -340,6 +338,7 @@ export interface PhoneCallResponse {
     | PhoneCallResponse.Utterance
     | PhoneCallResponse.ToolCallInvocationUtterance
     | PhoneCallResponse.ToolCallResultUtterance
+    | PhoneCallResponse.NodeTransitionUtterance
     | PhoneCallResponse.DtmfUtterance
   >;
 
@@ -375,6 +374,7 @@ export interface PhoneCallResponse {
     | PhoneCallResponse.Utterance
     | PhoneCallResponse.ToolCallInvocationUtterance
     | PhoneCallResponse.ToolCallResultUtterance
+    | PhoneCallResponse.NodeTransitionUtterance
     | PhoneCallResponse.DtmfUtterance
   >;
 
@@ -383,9 +383,15 @@ export interface PhoneCallResponse {
    * 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 namespace PhoneCallResponse {
@@ -460,6 +466,11 @@ export namespace PhoneCallResponse {
        */
       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.
        */
@@ -930,6 +941,12 @@ export 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;
   }
 
   export interface ToolCallResultUtterance {
@@ -939,7 +956,7 @@ export namespace PhoneCallResponse {
     content: string;
 
     /**
-     * This is result of a tool call.
+     * This is the result of a tool call.
      */
     role: 'tool_call_result';
 
@@ -949,6 +966,33 @@ export namespace PhoneCallResponse {
     tool_call_id: string;
   }
 
+  export 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';
+  }
+
   export interface DtmfUtterance {
     /**
      * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -957,7 +1001,7 @@ export namespace PhoneCallResponse {
     digit: string;
 
     /**
-     * This is user pressed digit from their phone keypad.
+     * Digit pressed by the user from their phone keypad.
      */
     role: 'dtmf';
   }
@@ -1073,6 +1117,12 @@ export 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;
   }
 
   export interface ToolCallResultUtterance {
@@ -1082,7 +1132,7 @@ export namespace PhoneCallResponse {
     content: string;
 
     /**
-     * This is result of a tool call.
+     * This is the result of a tool call.
      */
     role: 'tool_call_result';
 
@@ -1092,6 +1142,33 @@ export namespace PhoneCallResponse {
     tool_call_id: string;
   }
 
+  export 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';
+  }
+
   export interface DtmfUtterance {
     /**
      * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -1100,7 +1177,7 @@ export namespace PhoneCallResponse {
     digit: string;
 
     /**
-     * This is user pressed digit from their phone keypad.
+     * Digit pressed by the user from their phone keypad.
      */
     role: 'dtmf';
   }
@@ -1124,8 +1201,8 @@ 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;
 
@@ -1133,12 +1210,9 @@ export interface WebCallResponse {
    * 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';
@@ -1307,6 +1381,7 @@ export interface WebCallResponse {
     | WebCallResponse.Utterance
     | WebCallResponse.ToolCallInvocationUtterance
     | WebCallResponse.ToolCallResultUtterance
+    | WebCallResponse.NodeTransitionUtterance
     | WebCallResponse.DtmfUtterance
   >;
 
@@ -1336,6 +1411,7 @@ export interface WebCallResponse {
     | WebCallResponse.Utterance
     | WebCallResponse.ToolCallInvocationUtterance
     | WebCallResponse.ToolCallResultUtterance
+    | WebCallResponse.NodeTransitionUtterance
     | WebCallResponse.DtmfUtterance
   >;
 
@@ -1344,9 +1420,15 @@ export interface WebCallResponse {
    * 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 namespace WebCallResponse {
@@ -1421,6 +1503,11 @@ export namespace WebCallResponse {
        */
       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.
        */
@@ -1891,6 +1978,12 @@ export 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;
   }
 
   export interface ToolCallResultUtterance {
@@ -1900,7 +1993,7 @@ export namespace WebCallResponse {
     content: string;
 
     /**
-     * This is result of a tool call.
+     * This is the result of a tool call.
      */
     role: 'tool_call_result';
 
@@ -1910,6 +2003,33 @@ export namespace WebCallResponse {
     tool_call_id: string;
   }
 
+  export 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';
+  }
+
   export interface DtmfUtterance {
     /**
      * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -1918,7 +2038,7 @@ export namespace WebCallResponse {
     digit: string;
 
     /**
-     * This is user pressed digit from their phone keypad.
+     * Digit pressed by the user from their phone keypad.
      */
     role: 'dtmf';
   }
@@ -2023,6 +2143,12 @@ export 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;
   }
 
   export interface ToolCallResultUtterance {
@@ -2032,7 +2158,7 @@ export namespace WebCallResponse {
     content: string;
 
     /**
-     * This is result of a tool call.
+     * This is the result of a tool call.
      */
     role: 'tool_call_result';
 
@@ -2042,6 +2168,33 @@ export namespace WebCallResponse {
     tool_call_id: string;
   }
 
+  export 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';
+  }
+
   export interface DtmfUtterance {
     /**
      * The digit pressed by the user. Will be a single digit string like "1", "2", "3",
@@ -2050,7 +2203,7 @@ export namespace WebCallResponse {
     digit: string;
 
     /**
-     * This is user pressed digit from their phone keypad.
+     * Digit pressed by the user from their phone keypad.
      */
     role: 'dtmf';
   }
@@ -2059,6 +2212,11 @@ export namespace WebCallResponse {
 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
@@ -2185,8 +2343,19 @@ export namespace CallListParams {
      */
     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).
      */
@@ -2197,6 +2366,12 @@ export namespace CallListParams {
      */
     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).
      */
@@ -2234,6 +2409,15 @@ export namespace CallListParams {
       upper_threshold?: number;
     }
 
+    /**
+     * Only retrieve calls with specific range of end timestamp(s).
+     */
+    export interface EndTimestamp {
+      lower_threshold?: number;
+
+      upper_threshold?: number;
+    }
+
     /**
      * Only retrieve calls with specific range of start timestamp(s).
      */
@@ -2360,24 +2544,18 @@ export 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'
@@ -2441,6 +2619,11 @@ export namespace CallCreatePhoneCallParams {
        */
       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
@@ -2455,9 +2638,10 @@ export 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
@@ -2467,6 +2651,18 @@ export namespace CallCreatePhoneCallParams {
        */
       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).
@@ -2482,6 +2678,12 @@ export namespace CallCreatePhoneCallParams {
        */
       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
@@ -2491,11 +2693,24 @@ export namespace CallCreatePhoneCallParams {
        */
       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'
@@ -2520,11 +2735,11 @@ export namespace CallCreatePhoneCallParams {
         | 'nl-BE'
         | 'pl-PL'
         | 'tr-TR'
-        | 'th-TH'
         | 'vi-VN'
         | 'ro-RO'
         | 'bg-BG'
         | 'ca-ES'
+        | 'th-TH'
         | 'da-DK'
         | 'fi-FI'
         | 'el-GR'
@@ -2533,6 +2748,34 @@ export namespace CallCreatePhoneCallParams {
         | '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';
 
       /**
@@ -2585,12 +2828,15 @@ export namespace CallCreatePhoneCallParams {
         | '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;
 
       /**
@@ -2648,12 +2894,18 @@ export namespace CallCreatePhoneCallParams {
 
       /**
        * 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.
@@ -2661,6 +2913,12 @@ export namespace CallCreatePhoneCallParams {
        */
       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.
@@ -2668,10 +2926,9 @@ export namespace CallCreatePhoneCallParams {
       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'
@@ -2679,8 +2936,14 @@ export namespace CallCreatePhoneCallParams {
         | '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;
 
       /**
@@ -2698,6 +2961,21 @@ export namespace CallCreatePhoneCallParams {
        */
       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
@@ -2713,6 +2991,21 @@ export namespace CallCreatePhoneCallParams {
        */
       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.
@@ -2729,6 +3022,65 @@ export namespace CallCreatePhoneCallParams {
     }
 
     export namespace Agent {
+      /**
+       * Custom STT configuration. Only used when stt_mode is set to custom.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export interface IvrOption {
+        action: IvrOption.Action;
+      }
+
+      export namespace IvrOption {
+        export interface Action {
+          type: 'hangup';
+        }
+      }
+
       /**
        * Configuration for PII scrubbing from transcripts and recordings.
        */
@@ -2750,6 +3102,7 @@ export namespace CallCreatePhoneCallParams {
           | 'pin'
           | 'medical_id'
           | 'date_of_birth'
+          | 'customer_account_number'
         >;
 
         /**
@@ -2909,7 +3262,7 @@ export namespace CallCreatePhoneCallParams {
 
         /**
          * 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;
 
@@ -2930,7 +3283,8 @@ export namespace CallCreatePhoneCallParams {
         action:
           | VoicemailOption.VoicemailActionPrompt
           | VoicemailOption.VoicemailActionStaticText
-          | VoicemailOption.VoicemailActionHangup;
+          | VoicemailOption.VoicemailActionHangup
+          | VoicemailOption.VoicemailActionBridgeTransfer;
       }
 
       export namespace VoicemailOption {
@@ -2956,6 +3310,10 @@ export namespace CallCreatePhoneCallParams {
         export interface VoicemailActionHangup {
           type: 'hangup';
         }
+
+        export interface VoicemailActionBridgeTransfer {
+          type: 'bridge_transfer';
+        }
       }
     }
 
@@ -3035,12 +3393,15 @@ export namespace CallCreatePhoneCallParams {
           | '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-2.5-flash-lite'
+          | 'gemini-3.0-flash';
 
         /**
          * Type of model choice
@@ -3094,12 +3455,15 @@ export namespace CallCreatePhoneCallParams {
         | '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;
 
       /**
@@ -3121,7 +3485,7 @@ export 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
@@ -3243,24 +3607,18 @@ export 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'
@@ -3324,6 +3682,11 @@ export namespace CallCreateWebCallParams {
        */
       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
@@ -3338,9 +3701,10 @@ export 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
@@ -3350,6 +3714,18 @@ export namespace CallCreateWebCallParams {
        */
       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).
@@ -3365,6 +3741,12 @@ export namespace CallCreateWebCallParams {
        */
       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
@@ -3374,11 +3756,24 @@ export namespace CallCreateWebCallParams {
        */
       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'
@@ -3403,11 +3798,11 @@ export namespace CallCreateWebCallParams {
         | 'nl-BE'
         | 'pl-PL'
         | 'tr-TR'
-        | 'th-TH'
         | 'vi-VN'
         | 'ro-RO'
         | 'bg-BG'
         | 'ca-ES'
+        | 'th-TH'
         | 'da-DK'
         | 'fi-FI'
         | 'el-GR'
@@ -3416,6 +3811,34 @@ export namespace CallCreateWebCallParams {
         | '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';
 
       /**
@@ -3468,12 +3891,15 @@ export namespace CallCreateWebCallParams {
         | '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;
 
       /**
@@ -3531,12 +3957,18 @@ export namespace CallCreateWebCallParams {
 
       /**
        * 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.
@@ -3544,6 +3976,12 @@ export namespace CallCreateWebCallParams {
        */
       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.
@@ -3551,10 +3989,9 @@ export namespace CallCreateWebCallParams {
       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'
@@ -3562,8 +3999,14 @@ export namespace CallCreateWebCallParams {
         | '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;
 
       /**
@@ -3581,6 +4024,21 @@ export namespace CallCreateWebCallParams {
        */
       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
@@ -3596,6 +4054,21 @@ export namespace CallCreateWebCallParams {
        */
       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.
@@ -3612,6 +4085,65 @@ export namespace CallCreateWebCallParams {
     }
 
     export namespace Agent {
+      /**
+       * Custom STT configuration. Only used when stt_mode is set to custom.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export interface IvrOption {
+        action: IvrOption.Action;
+      }
+
+      export namespace IvrOption {
+        export interface Action {
+          type: 'hangup';
+        }
+      }
+
       /**
        * Configuration for PII scrubbing from transcripts and recordings.
        */
@@ -3633,6 +4165,7 @@ export namespace CallCreateWebCallParams {
           | 'pin'
           | 'medical_id'
           | 'date_of_birth'
+          | 'customer_account_number'
         >;
 
         /**
@@ -3792,7 +4325,7 @@ export namespace CallCreateWebCallParams {
 
         /**
          * 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;
 
@@ -3813,7 +4346,8 @@ export namespace CallCreateWebCallParams {
         action:
           | VoicemailOption.VoicemailActionPrompt
           | VoicemailOption.VoicemailActionStaticText
-          | VoicemailOption.VoicemailActionHangup;
+          | VoicemailOption.VoicemailActionHangup
+          | VoicemailOption.VoicemailActionBridgeTransfer;
       }
 
       export namespace VoicemailOption {
@@ -3839,6 +4373,10 @@ export namespace CallCreateWebCallParams {
         export interface VoicemailActionHangup {
           type: 'hangup';
         }
+
+        export interface VoicemailActionBridgeTransfer {
+          type: 'bridge_transfer';
+        }
       }
     }
 
@@ -3918,12 +4456,15 @@ export namespace CallCreateWebCallParams {
           | '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-2.5-flash-lite'
+          | 'gemini-3.0-flash';
 
         /**
          * Type of model choice
@@ -3977,12 +4518,15 @@ export namespace CallCreateWebCallParams {
         | '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;
 
       /**
@@ -4004,7 +4548,7 @@ export 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
@@ -4140,24 +4684,18 @@ export 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'
@@ -4221,6 +4759,11 @@ export namespace CallRegisterPhoneCallParams {
        */
       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
@@ -4235,9 +4778,10 @@ export 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
@@ -4247,6 +4791,18 @@ export namespace CallRegisterPhoneCallParams {
        */
       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).
@@ -4262,6 +4818,12 @@ export namespace CallRegisterPhoneCallParams {
        */
       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
@@ -4271,11 +4833,24 @@ export namespace CallRegisterPhoneCallParams {
        */
       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'
@@ -4300,11 +4875,11 @@ export namespace CallRegisterPhoneCallParams {
         | 'nl-BE'
         | 'pl-PL'
         | 'tr-TR'
-        | 'th-TH'
         | 'vi-VN'
         | 'ro-RO'
         | 'bg-BG'
         | 'ca-ES'
+        | 'th-TH'
         | 'da-DK'
         | 'fi-FI'
         | 'el-GR'
@@ -4313,6 +4888,34 @@ export namespace CallRegisterPhoneCallParams {
         | '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';
 
       /**
@@ -4365,12 +4968,15 @@ export namespace CallRegisterPhoneCallParams {
         | '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;
 
       /**
@@ -4428,12 +5034,18 @@ export namespace CallRegisterPhoneCallParams {
 
       /**
        * 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.
@@ -4441,6 +5053,12 @@ export namespace CallRegisterPhoneCallParams {
        */
       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.
@@ -4448,10 +5066,9 @@ export namespace CallRegisterPhoneCallParams {
       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'
@@ -4459,8 +5076,14 @@ export namespace CallRegisterPhoneCallParams {
         | '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;
 
       /**
@@ -4478,6 +5101,21 @@ export namespace CallRegisterPhoneCallParams {
        */
       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
@@ -4493,6 +5131,21 @@ export namespace CallRegisterPhoneCallParams {
        */
       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.
@@ -4509,6 +5162,65 @@ export namespace CallRegisterPhoneCallParams {
     }
 
     export namespace Agent {
+      /**
+       * Custom STT configuration. Only used when stt_mode is set to custom.
+       */
+      export 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.
+       */
+      export 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.
+       */
+      export interface IvrOption {
+        action: IvrOption.Action;
+      }
+
+      export namespace IvrOption {
+        export interface Action {
+          type: 'hangup';
+        }
+      }
+
       /**
        * Configuration for PII scrubbing from transcripts and recordings.
        */
@@ -4530,6 +5242,7 @@ export namespace CallRegisterPhoneCallParams {
           | 'pin'
           | 'medical_id'
           | 'date_of_birth'
+          | 'customer_account_number'
         >;
 
         /**
@@ -4689,7 +5402,7 @@ export namespace CallRegisterPhoneCallParams {
 
         /**
          * 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;
 
@@ -4710,7 +5423,8 @@ export namespace CallRegisterPhoneCallParams {
         action:
           | VoicemailOption.VoicemailActionPrompt
           | VoicemailOption.VoicemailActionStaticText
-          | VoicemailOption.VoicemailActionHangup;
+          | VoicemailOption.VoicemailActionHangup
+          | VoicemailOption.VoicemailActionBridgeTransfer;
       }
 
       export namespace VoicemailOption {
@@ -4736,6 +5450,10 @@ export namespace CallRegisterPhoneCallParams {
         export interface VoicemailActionHangup {
           type: 'hangup';
         }
+
+        export interface VoicemailActionBridgeTransfer {
+          type: 'bridge_transfer';
+        }
       }
     }
 
@@ -4815,12 +5533,15 @@ export namespace CallRegisterPhoneCallParams {
           | '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-2.5-flash-lite'
+          | 'gemini-3.0-flash';
 
         /**
          * Type of model choice
@@ -4874,12 +5595,15 @@ export namespace CallRegisterPhoneCallParams {
         | '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;
 
       /**
@@ -4901,7 +5625,7 @@ export 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