retell-sdk 4.66.0 → 5.1.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';
@@ -225,6 +223,7 @@ export interface PhoneCallResponse {
     | 'agent_hangup'
     | 'call_transfer'
     | 'voicemail_reached'
+    | 'ivr_reached'
     | 'inactivity'
     | 'max_duration_reached'
     | 'concurrency_limit_reached'
@@ -340,6 +339,7 @@ export interface PhoneCallResponse {
     | PhoneCallResponse.Utterance
     | PhoneCallResponse.ToolCallInvocationUtterance
     | PhoneCallResponse.ToolCallResultUtterance
+    | PhoneCallResponse.NodeTransitionUtterance
     | PhoneCallResponse.DtmfUtterance
   >;
 
@@ -375,6 +375,7 @@ export interface PhoneCallResponse {
     | PhoneCallResponse.Utterance
     | PhoneCallResponse.ToolCallInvocationUtterance
     | PhoneCallResponse.ToolCallResultUtterance
+    | PhoneCallResponse.NodeTransitionUtterance
     | PhoneCallResponse.DtmfUtterance
   >;
 
@@ -383,9 +384,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 +467,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 +942,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 +957,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 +967,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 +1002,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 +1118,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 +1133,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 +1143,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 +1178,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 +1202,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 +1211,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';
@@ -1192,6 +1267,7 @@ export interface WebCallResponse {
     | 'agent_hangup'
     | 'call_transfer'
     | 'voicemail_reached'
+    | 'ivr_reached'
     | 'inactivity'
     | 'max_duration_reached'
     | 'concurrency_limit_reached'
@@ -1307,6 +1383,7 @@ export interface WebCallResponse {
     | WebCallResponse.Utterance
     | WebCallResponse.ToolCallInvocationUtterance
     | WebCallResponse.ToolCallResultUtterance
+    | WebCallResponse.NodeTransitionUtterance
     | WebCallResponse.DtmfUtterance
   >;
 
@@ -1336,6 +1413,7 @@ export interface WebCallResponse {
     | WebCallResponse.Utterance
     | WebCallResponse.ToolCallInvocationUtterance
     | WebCallResponse.ToolCallResultUtterance
+    | WebCallResponse.NodeTransitionUtterance
     | WebCallResponse.DtmfUtterance
   >;
 
@@ -1344,9 +1422,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 +1505,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 +1980,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 +1995,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 +2005,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 +2040,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 +2145,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 +2160,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 +2170,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 +2205,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 +2214,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
@@ -2154,6 +2314,7 @@ export namespace CallListParams {
       | 'agent_hangup'
       | 'call_transfer'
       | 'voicemail_reached'
+      | 'ivr_reached'
       | 'inactivity'
       | 'max_duration_reached'
       | 'concurrency_limit_reached'
@@ -2185,8 +2346,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 +2369,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 +2412,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 +2547,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 +2622,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 +2641,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 +2654,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 +2681,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,6 +2696,19 @@ 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
@@ -2533,6 +2751,9 @@ export namespace CallCreatePhoneCallParams {
         | 'no-NO'
         | 'sk-SK'
         | 'sv-SE'
+        | 'lt-LT'
+        | 'lv-LV'
+        | 'cs-CZ'
         | 'ms-MY'
         | 'af-ZA'
         | 'ar-SA'
@@ -2610,12 +2831,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;
 
       /**
@@ -2673,12 +2897,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.
@@ -2686,6 +2916,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.
@@ -2693,10 +2929,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'
@@ -2704,8 +2939,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;
 
       /**
@@ -2723,6 +2964,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
@@ -2738,6 +2994,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.
@@ -2754,6 +3025,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.
        */
@@ -2775,6 +3105,7 @@ export namespace CallCreatePhoneCallParams {
           | 'pin'
           | 'medical_id'
           | 'date_of_birth'
+          | 'customer_account_number'
         >;
 
         /**
@@ -2934,7 +3265,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;
 
@@ -2955,7 +3286,8 @@ export namespace CallCreatePhoneCallParams {
         action:
           | VoicemailOption.VoicemailActionPrompt
           | VoicemailOption.VoicemailActionStaticText
-          | VoicemailOption.VoicemailActionHangup;
+          | VoicemailOption.VoicemailActionHangup
+          | VoicemailOption.VoicemailActionBridgeTransfer;
       }
 
       export namespace VoicemailOption {
@@ -2981,6 +3313,10 @@ export namespace CallCreatePhoneCallParams {
         export interface VoicemailActionHangup {
           type: 'hangup';
         }
+
+        export interface VoicemailActionBridgeTransfer {
+          type: 'bridge_transfer';
+        }
       }
     }
 
@@ -3060,12 +3396,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
@@ -3119,12 +3458,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;
 
       /**
@@ -3146,7 +3488,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
@@ -3268,24 +3610,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'
@@ -3349,6 +3685,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
@@ -3363,9 +3704,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
@@ -3375,6 +3717,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).
@@ -3390,6 +3744,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
@@ -3399,6 +3759,19 @@ 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
@@ -3441,6 +3814,9 @@ export namespace CallCreateWebCallParams {
         | 'no-NO'
         | 'sk-SK'
         | 'sv-SE'
+        | 'lt-LT'
+        | 'lv-LV'
+        | 'cs-CZ'
         | 'ms-MY'
         | 'af-ZA'
         | 'ar-SA'
@@ -3518,12 +3894,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;
 
       /**
@@ -3581,12 +3960,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.
@@ -3594,6 +3979,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.
@@ -3601,10 +3992,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'
@@ -3612,8 +4002,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;
 
       /**
@@ -3631,6 +4027,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
@@ -3646,6 +4057,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.
@@ -3662,6 +4088,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.
        */
@@ -3683,6 +4168,7 @@ export namespace CallCreateWebCallParams {
           | 'pin'
           | 'medical_id'
           | 'date_of_birth'
+          | 'customer_account_number'
         >;
 
         /**
@@ -3842,7 +4328,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;
 
@@ -3863,7 +4349,8 @@ export namespace CallCreateWebCallParams {
         action:
           | VoicemailOption.VoicemailActionPrompt
           | VoicemailOption.VoicemailActionStaticText
-          | VoicemailOption.VoicemailActionHangup;
+          | VoicemailOption.VoicemailActionHangup
+          | VoicemailOption.VoicemailActionBridgeTransfer;
       }
 
       export namespace VoicemailOption {
@@ -3889,6 +4376,10 @@ export namespace CallCreateWebCallParams {
         export interface VoicemailActionHangup {
           type: 'hangup';
         }
+
+        export interface VoicemailActionBridgeTransfer {
+          type: 'bridge_transfer';
+        }
       }
     }
 
@@ -3968,12 +4459,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
@@ -4027,12 +4521,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;
 
       /**
@@ -4054,7 +4551,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
@@ -4190,24 +4687,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'
@@ -4271,6 +4762,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
@@ -4285,9 +4781,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
@@ -4297,6 +4794,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).
@@ -4312,6 +4821,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
@@ -4321,6 +4836,19 @@ 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
@@ -4363,6 +4891,9 @@ export namespace CallRegisterPhoneCallParams {
         | 'no-NO'
         | 'sk-SK'
         | 'sv-SE'
+        | 'lt-LT'
+        | 'lv-LV'
+        | 'cs-CZ'
         | 'ms-MY'
         | 'af-ZA'
         | 'ar-SA'
@@ -4440,12 +4971,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;
 
       /**
@@ -4503,12 +5037,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.
@@ -4516,6 +5056,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.
@@ -4523,10 +5069,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'
@@ -4534,8 +5079,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;
 
       /**
@@ -4553,6 +5104,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
@@ -4568,6 +5134,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.
@@ -4584,6 +5165,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.
        */
@@ -4605,6 +5245,7 @@ export namespace CallRegisterPhoneCallParams {
           | 'pin'
           | 'medical_id'
           | 'date_of_birth'
+          | 'customer_account_number'
         >;
 
         /**
@@ -4764,7 +5405,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;
 
@@ -4785,7 +5426,8 @@ export namespace CallRegisterPhoneCallParams {
         action:
           | VoicemailOption.VoicemailActionPrompt
           | VoicemailOption.VoicemailActionStaticText
-          | VoicemailOption.VoicemailActionHangup;
+          | VoicemailOption.VoicemailActionHangup
+          | VoicemailOption.VoicemailActionBridgeTransfer;
       }
 
       export namespace VoicemailOption {
@@ -4811,6 +5453,10 @@ export namespace CallRegisterPhoneCallParams {
         export interface VoicemailActionHangup {
           type: 'hangup';
         }
+
+        export interface VoicemailActionBridgeTransfer {
+          type: 'bridge_transfer';
+        }
       }
     }
 
@@ -4890,12 +5536,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
@@ -4949,12 +5598,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;
 
       /**
@@ -4976,7 +5628,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