telnyx 7.25.0 → 7.26.0

package/src/client.ts

@@ -305,6 +305,7 @@ import {
 } from './resources/email-events';
 import {
   EmailTemplate,
+  EmailTemplateCommon,
   EmailTemplateCreateParams,
   EmailTemplateListParams,
   EmailTemplateRenderParams,
@@ -872,6 +873,11 @@ import {
   SimCardOrders,
   SimCardOrdersDefaultFlatPagination,
 } from './resources/sim-card-orders';
+import {
+  SipRegistrationStatus,
+  SipRegistrationStatusListParams,
+  SipRegistrationStatusListResponse,
+} from './resources/sip-registration-status';
 import {
   SiprecConnectorCreateParams,
   SiprecConnectorResponse,
@@ -1065,6 +1071,7 @@ import {
   CallConversationEndedWebhookEvent,
   CallConversationInsightsGenerated,
   CallConversationInsightsGeneratedWebhookEvent,
+  CallConversationStartFailedWebhookEvent,
   CallCostWebhookEvent,
   CallDeepfakeDetectionErrorWebhookEvent,
   CallDeepfakeDetectionResultWebhookEvent,
@@ -1171,6 +1178,9 @@ import {
   MessagingInboundMessage,
   NumberOrderStatusUpdate,
   NumberOrderStatusUpdateWebhookEvent,
+  NumberReputationExternalVerificationStatusChangedWebhookEvent,
+  NumberReputationNumberFlaggedWebhookEvent,
+  NumberReputationNumberRemovedWebhookEvent,
   OutboundMessage,
   RecordingAvailableWebhookEvent,
   ReplacedLinkClick,
@@ -1184,6 +1194,7 @@ import {
   Webhooks,
   WhatsappAccountUpdate,
   WhatsappMessageEcho,
+  WhatsappWabaAddedWebhookEvent,
 } from './resources/webhooks';
 import {
   WellKnown,
@@ -3323,6 +3334,10 @@ export class Telnyx {
    */
   spendLimits: API.SpendLimits = new API.SpendLimits(this);
   llmTokenGateway: API.LlmTokenGateway = new API.LlmTokenGateway(this);
+  /**
+   * UAC connection operations
+   */
+  sipRegistrationStatus: API.SipRegistrationStatus = new API.SipRegistrationStatus(this);
 }
 
 Telnyx.Legacy = Legacy;
@@ -3515,6 +3530,7 @@ Telnyx.BotSignup = BotSignup;
 Telnyx.MachinePayments = MachinePayments;
 Telnyx.SpendLimits = SpendLimits;
 Telnyx.LlmTokenGateway = LlmTokenGateway;
+Telnyx.SipRegistrationStatus = SipRegistrationStatus;
 
 export declare namespace Telnyx {
   export type RequestOptions = Opts.RequestOptions;
@@ -3708,6 +3724,7 @@ export declare namespace Telnyx {
     type CallConversationCreatedWebhookEvent as CallConversationCreatedWebhookEvent,
     type CallConversationEndedWebhookEvent as CallConversationEndedWebhookEvent,
     type CallConversationInsightsGeneratedWebhookEvent as CallConversationInsightsGeneratedWebhookEvent,
+    type CallConversationStartFailedWebhookEvent as CallConversationStartFailedWebhookEvent,
     type CallCostWebhookEvent as CallCostWebhookEvent,
     type CallDeepfakeDetectionErrorWebhookEvent as CallDeepfakeDetectionErrorWebhookEvent,
     type CallDeepfakeDetectionResultWebhookEvent as CallDeepfakeDetectionResultWebhookEvent,
@@ -3762,11 +3779,15 @@ export declare namespace Telnyx {
     type HostedNumberOrderEventWebhookEvent as HostedNumberOrderEventWebhookEvent,
     type InboundMessageWebhookEvent as InboundMessageWebhookEvent,
     type NumberOrderStatusUpdateWebhookEvent as NumberOrderStatusUpdateWebhookEvent,
+    type NumberReputationExternalVerificationStatusChangedWebhookEvent as NumberReputationExternalVerificationStatusChangedWebhookEvent,
+    type NumberReputationNumberFlaggedWebhookEvent as NumberReputationNumberFlaggedWebhookEvent,
+    type NumberReputationNumberRemovedWebhookEvent as NumberReputationNumberRemovedWebhookEvent,
     type RecordingAvailableWebhookEvent as RecordingAvailableWebhookEvent,
     type ReplacedLinkClickWebhookEvent as ReplacedLinkClickWebhookEvent,
     type SessionStatusChangedWebhookEvent as SessionStatusChangedWebhookEvent,
     type TranscriptCompletedWebhookEvent as TranscriptCompletedWebhookEvent,
     type TranscriptionWebhookEvent as TranscriptionWebhookEvent,
+    type WhatsappWabaAddedWebhookEvent as WhatsappWabaAddedWebhookEvent,
     type UnsafeUnwrapWebhookEvent as UnsafeUnwrapWebhookEvent,
     type UnwrapWebhookEvent as UnwrapWebhookEvent,
   };
@@ -5491,6 +5512,7 @@ export declare namespace Telnyx {
   export {
     EmailTemplates as EmailTemplates,
     type EmailTemplate as EmailTemplate,
+    type EmailTemplateCommon as EmailTemplateCommon,
     type EmailTemplateResponse as EmailTemplateResponse,
     type UpdateEmailTemplateRequest as UpdateEmailTemplateRequest,
     type EmailTemplateRenderResponse as EmailTemplateRenderResponse,
@@ -5603,6 +5625,12 @@ export declare namespace Telnyx {
 
   export { LlmTokenGateway as LlmTokenGateway };
 
+  export {
+    SipRegistrationStatus as SipRegistrationStatus,
+    type SipRegistrationStatusListResponse as SipRegistrationStatusListResponse,
+    type SipRegistrationStatusListParams as SipRegistrationStatusListParams,
+  };
+
   export type APIError = API.APIError;
   export type AvailablePhoneNumbersMetadata = API.AvailablePhoneNumbersMetadata;
   export type AzureVoiceSettings = API.AzureVoiceSettings;

package/src/resources/ai/ai.ts

@@ -8,6 +8,18 @@ import {
   AudioTranscribeResponse,
   AudioTranscriptionResponseWord,
 } from './audio';
+import * as AvatarsAPI from './avatars';
+import {
+  Avatar,
+  AvatarCreateParams,
+  AvatarID,
+  AvatarListParams,
+  AvatarResponse,
+  AvatarType,
+  AvatarUpdateParams,
+  Avatars,
+  AvatarsDefaultFlatPagination,
+} from './avatars';
 import * as ChatAPI from './chat';
 import { BucketIDs, Chat, ChatCompletionRequest } from './chat';
 import * as ClustersAPI from './clusters';
@@ -71,6 +83,7 @@ import {
   AssistantsList,
   AudioVisualizerConfig,
   AuthenticationMethod,
+  AvatarSettingsRequest,
   BooleanOpExpression,
   ComparisonExpression,
   ConversationFlow,
@@ -107,6 +120,7 @@ import {
   SpeakNodeReq,
   StartSpeakingPlan,
   TelephonySettings,
+  TelnyxAvatarSettings,
   ToolNode,
   ToolNodeReq,
   TranscriptionEndpointingPlan,
@@ -203,6 +217,7 @@ export class AI extends APIResource {
   knowledge: KnowledgeAPI.Knowledge = new KnowledgeAPI.Knowledge(this._client);
   typesafe: TypesafeAPI.Typesafe = new TypesafeAPI.Typesafe(this._client);
   memory: MemoryAPI.Memory = new MemoryAPI.Memory(this._client);
+  avatars: AvatarsAPI.Avatars = new AvatarsAPI.Avatars(this._client);
 
   /**
    * Generate a summary of a file's contents.
@@ -402,9 +417,14 @@ export interface ModelMetadata {
   is_vision_supported?: boolean;
 
   /**
-   * Maximum completion (output) tokens the model may generate per request. This
-   * value caps the Chat Completions `max_tokens` default and any larger explicit
-   * value on that model. `null` if unconstrained beyond `context_length`.
+   * Model-specific completion-token ceiling. For Chat Completions, this value clamps
+   * explicit output limits and the 8192 default when that default applies. Models
+   * excluded from the default leave an omitted or null output limit unset for the
+   * serving engine, even when this metadata declares a ceiling; see
+   * `ChatCompletionRequest.max_tokens` for the hosted default and exclusion lists.
+   * This field does not report the effective default. `null` means no separate
+   * completion ceiling is declared; input and output together must still fit
+   * `context_length`.
    */
   max_completion_tokens?: number | null;
 
@@ -652,6 +672,7 @@ AI.Anthropic = Anthropic;
 AI.Knowledge = Knowledge;
 AI.Typesafe = Typesafe;
 AI.Memory = Memory;
+AI.Avatars = Avatars;
 
 export declare namespace AI {
   export {
@@ -675,6 +696,7 @@ export declare namespace AI {
     type AssistantsList as AssistantsList,
     type AudioVisualizerConfig as AudioVisualizerConfig,
     type AuthenticationMethod as AuthenticationMethod,
+    type AvatarSettingsRequest as AvatarSettingsRequest,
     type BooleanOpExpression as BooleanOpExpression,
     type ComparisonExpression as ComparisonExpression,
     type ConversationFlow as ConversationFlow,
@@ -711,6 +733,7 @@ export declare namespace AI {
     type SpeakNodeReq as SpeakNodeReq,
     type StartSpeakingPlan as StartSpeakingPlan,
     type TelephonySettings as TelephonySettings,
+    type TelnyxAvatarSettings as TelnyxAvatarSettings,
     type ToolNode as ToolNode,
     type ToolNodeReq as ToolNodeReq,
     type TranscriptionEndpointingPlan as TranscriptionEndpointingPlan,
@@ -850,4 +873,16 @@ export declare namespace AI {
   export { Typesafe as Typesafe };
 
   export { Memory as Memory };
+
+  export {
+    Avatars as Avatars,
+    type Avatar as Avatar,
+    type AvatarID as AvatarID,
+    type AvatarResponse as AvatarResponse,
+    type AvatarType as AvatarType,
+    type AvatarsDefaultFlatPagination as AvatarsDefaultFlatPagination,
+    type AvatarListParams as AvatarListParams,
+    type AvatarCreateParams as AvatarCreateParams,
+    type AvatarUpdateParams as AvatarUpdateParams,
+  };
 }

package/src/resources/ai/assistants/assistants.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../../core/resource';
 import * as AssistantsAPI from './assistants';
 import * as Shared from '../../shared';
+import * as AvatarsAPI from '../avatars';
 import * as ChatAPI from '../chat';
 import * as ToolsAPI from '../tools';
 import * as CanaryDeploysAPI from './canary-deploys';
@@ -1095,6 +1096,20 @@ export namespace AssistantTool {
          * `shared` the exchange stays in the conversation like any other messages.
          */
         end_user_target_context_mode?: 'private' | 'shared';
+
+        /**
+         * Fail closed when the acceptance consult cannot run. Off by default: if the
+         * consult cannot be set up for any reason — including where acceptance is
+         * unavailable at all (`gather_using_ai`, Conversation Relay or web calls, a
+         * conference, or additional invited participants) — the transfer degrades to a
+         * plain warm transfer (the warm transfer message is played to the destination as
+         * audio and the calls are bridged anyway). Set to true to treat those paths as a
+         * decline instead: the destination is disconnected without being asked, the
+         * assistant returns to the caller, and no bridge happens without an acceptance.
+         * Only consult-setup failures are affected; the destination must still explicitly
+         * accept on every consult that does run.
+         */
+        require_acceptance?: boolean;
       }
     }
   }
@@ -1440,6 +1455,34 @@ export interface AudioVisualizerConfig {
  */
 export type AuthenticationMethod = 'token' | 'certificate';
 
+/**
+ * **Beta:** Configuration for the Telnyx open-source avatar provider. Use one of
+ * the six stock avatars or an organization-owned custom avatar returned by the
+ * Avatars API. Supported backgrounds are office, studio, and reception.
+ */
+export interface AvatarSettingsRequest {
+  /**
+   * The Telnyx stock avatar or organization-owned custom avatar to render.
+   */
+  avatar_id: AvatarsAPI.AvatarID;
+
+  /**
+   * The background to render.
+   */
+  background_id: 'office' | 'studio' | 'reception';
+
+  /**
+   * Required avatar model identifier, separate from `avatar_id`. The supported value
+   * is `foxtrot-1`. Omission, null, and unsupported model identifiers are rejected.
+   */
+  model: 'foxtrot-1';
+
+  /**
+   * Selects the Telnyx open-source avatar provider.
+   */
+  provider: 'telnyx';
+}
+
 /**
  * Combine sub-expressions with a logical operator (`and` / `or` / `not`).
  *
@@ -2112,7 +2155,11 @@ export interface FlowNodeReq {
 
   /**
    * Per-node transcription override (model/language/region). Unset fields cascade
-   * from the assistant-level transcription.
+   * from the assistant-level transcription. A node that sets `model`,
+   * `fallback_models`, or `challenger` doesn't inherit the assistant's
+   * `fallback_models` or `challenger`; it uses only the ones it sets. Otherwise it
+   * inherits them, and they must fit the model and language the node runs; a change
+   * they no longer fit is rejected.
    */
   transcription?: TranscriptionSettings;
 
@@ -2189,6 +2236,13 @@ export interface InferenceEmbedding {
    */
   a2a_agents?: Array<AssistantA2AAgent>;
 
+  /**
+   * **Beta:** Configuration for the Telnyx open-source avatar provider. Use one of
+   * the six stock avatars or an organization-owned custom avatar returned by the
+   * Avatars API. Supported backgrounds are office, studio, and reception.
+   */
+  avatar_settings?: TelnyxAvatarSettings | null;
+
   /**
    * Conversation flow as returned by the API.
    */
@@ -2426,8 +2480,8 @@ export interface InferenceEmbeddingVoiceSettings {
    * preview it before saving.
    */
   background_audio?:
-    | InferenceEmbeddingVoiceSettings.UnionMember0
-    | InferenceEmbeddingVoiceSettings.UnionMember1
+    | InferenceEmbeddingVoiceSettings.BackgroundAudioUnionMember0
+    | InferenceEmbeddingVoiceSettings.BackgroundAudioUnionMember1
     | InferenceEmbeddingVoiceSettings.UnionMember2;
 
   /**
@@ -2512,6 +2566,17 @@ export interface InferenceEmbeddingVoiceSettings {
    */
   temperature?: number;
 
+  /**
+   * Optional sound played to the caller while the assistant runs a tool (for example
+   * a webhook or MCP tool). It replaces the background audio until the tool
+   * responds, then the background audio resumes. Defaults to null, which plays no
+   * sound; send `null` on update to clear it. Not played in conference calls.
+   */
+  tool_call_audio?:
+    | InferenceEmbeddingVoiceSettings.ToolCallAudioUnionMember0
+    | InferenceEmbeddingVoiceSettings.ToolCallAudioUnionMember1
+    | null;
+
   /**
    * Amplifies similarity to the original speaker voice. Increases computational load
    * and latency slightly. Only applicable when using ElevenLabs.
@@ -2528,7 +2593,7 @@ export interface InferenceEmbeddingVoiceSettings {
 }
 
 export namespace InferenceEmbeddingVoiceSettings {
-  export interface UnionMember0 {
+  export interface BackgroundAudioUnionMember0 {
     /**
      * Select from predefined media options.
      */
@@ -2546,7 +2611,7 @@ export namespace InferenceEmbeddingVoiceSettings {
     volume?: number;
   }
 
-  export interface UnionMember1 {
+  export interface BackgroundAudioUnionMember1 {
     /**
      * Provide a direct URL to an MP3 file. The audio will loop during the call.
      */
@@ -2571,6 +2636,36 @@ export namespace InferenceEmbeddingVoiceSettings {
      */
     value: string;
   }
+
+  export interface ToolCallAudioUnionMember0 {
+    /**
+     * Select from predefined media options.
+     */
+    type: 'predefined_media';
+
+    /**
+     * The predefined media to use. `typing` plays a keyboard typing sound.
+     */
+    value: 'typing';
+
+    /**
+     * Volume level for the predefined media. Supports values from 0.0 to 1.0 in 0.1
+     * increments. `0.0` plays no sound.
+     */
+    volume?: number;
+  }
+
+  export interface ToolCallAudioUnionMember1 {
+    /**
+     * Provide a direct URL to an MP3 file. The audio loops while the tool runs.
+     */
+    type: 'media_url';
+
+    /**
+     * HTTPS URL to an MP3 file.
+     */
+    value: string;
+  }
 }
 
 export interface InferenceEmbeddingWebhookToolParams {
@@ -3124,6 +3219,16 @@ export interface StartSpeakingPlan {
 }
 
 export interface TelephonySettings {
+  /**
+   * When enabled, the `messages` array of the `call.conversation.ended` webhook
+   * contains the full conversation history in order: user and assistant turns,
+   * assistant tool calls (`tool_calls`), tool results (`role: tool` with
+   * `tool_call_id`), and informational `system` and `developer` entries. The
+   * assistant's instructions are never included. When disabled, `messages` contains
+   * only user and assistant text turns.
+   */
+  conversation_ended_full_history?: boolean;
+
   /**
    * Default Texml App used for voice calls with your assistant. This will be created
    * automatically on assistant creation.
@@ -3349,6 +3454,34 @@ export namespace TelephonySettings {
   }
 }
 
+/**
+ * **Beta:** Configuration for the Telnyx open-source avatar provider. Use one of
+ * the six stock avatars or an organization-owned custom avatar returned by the
+ * Avatars API. Supported backgrounds are office, studio, and reception.
+ */
+export interface TelnyxAvatarSettings {
+  /**
+   * The Telnyx stock avatar or organization-owned custom avatar to render.
+   */
+  avatar_id: AvatarsAPI.AvatarID;
+
+  /**
+   * The background to render.
+   */
+  background_id: 'office' | 'studio' | 'reception';
+
+  /**
+   * Required avatar model identifier, separate from `avatar_id`. The supported value
+   * is `foxtrot-1`. Omission, null, and unsupported model identifiers are rejected.
+   */
+  model: 'foxtrot-1';
+
+  /**
+   * Selects the Telnyx open-source avatar provider.
+   */
+  provider: 'telnyx';
+}
+
 /**
  * A standalone tool step in a conversation flow, as returned by the API.
  */
@@ -3489,6 +3622,24 @@ export interface TranscriptionSettings {
    */
   api_key_ref?: string;
 
+  /**
+   * A second speech-to-text model that transcribes alongside `transcription.model`,
+   * and the rule that decides which transcript the assistant uses.
+   */
+  challenger?: TranscriptionSettings.Challenger | null;
+
+  /**
+   * Up to 3 streaming models that take over transcription, in this order, when the
+   * model in use fails, at the start of a call or mid-call. `model` must be a
+   * streaming model too, and must support `language` alongside other models. On
+   * update, a list replaces the stored one: omit the field to keep the stored list,
+   * or send `null` or `[]` to remove it. When an update changes `model` or
+   * `language`, stored fallbacks that no longer fit are removed without an error.
+   * Can't be combined with `challenger`, the language booster; to replace a stored
+   * language booster, send `challenger: null` in the same request.
+   */
+  fallback_models?: Array<TranscriptionSettings.FallbackModel> | null;
+
   /**
    * The language of the audio to be transcribed. If not set, or if set to `auto`,
    * supported models will automatically detect the language. For `deepgram/flux`,
@@ -3534,6 +3685,7 @@ export interface TranscriptionSettings {
    * - `reson8/turns` is a turn-based streaming model covering 10 European languages
    *   with automatic language detection.
    * - `cohere/ar-stt` is a non-streaming Arabic and English transcription model.
+   * - `telnyx/basira` is a non-streaming Arabic transcription model.
    */
   model?:
     | 'deepgram/flux'
@@ -3550,6 +3702,7 @@ export interface TranscriptionSettings {
     | 'humain/realtime'
     | 'reson8/turns'
     | 'cohere/ar-stt'
+    | 'telnyx/basira'
     | 'distil-whisper/distil-large-v2'
     | 'openai/whisper-large-v3-turbo';
 
@@ -3562,6 +3715,124 @@ export interface TranscriptionSettings {
   settings?: TranscriptionSettingsConfig;
 }
 
+export namespace TranscriptionSettings {
+  /**
+   * A second speech-to-text model that transcribes alongside `transcription.model`,
+   * and the rule that decides which transcript the assistant uses.
+   */
+  export interface Challenger {
+    /**
+     * The language booster's model. It must be the same kind of model as
+     * `transcription.model`: both streaming (`deepgram/flux`, `deepgram/nova-3`,
+     * `deepgram/nova-2`, `assemblyai/universal-3-5-pro` or its legacy alias
+     * `assemblyai/universal-streaming`, `xai/grok-stt`, `soniox/stt-rt-v4`,
+     * `soniox/stt-rt-v5`, `humain/realtime`, `reson8/turns`) or both non-streaming
+     * (`azure/fast`, `nvidia/parakeet-v3`, `omi-health/omi-med-stt-v1`,
+     * `cohere/ar-stt`, `distil-whisper/distil-large-v2`,
+     * `openai/whisper-large-v3-turbo`, `telnyx/basira`). It can be the same model as
+     * `transcription.model` on a different `language`.
+     */
+    model:
+      | 'deepgram/flux'
+      | 'deepgram/nova-3'
+      | 'deepgram/nova-2'
+      | 'azure/fast'
+      | 'assemblyai/universal-3-5-pro'
+      | 'assemblyai/universal-streaming'
+      | 'xai/grok-stt'
+      | 'soniox/stt-rt-v4'
+      | 'soniox/stt-rt-v5'
+      | 'nvidia/parakeet-v3'
+      | 'omi-health/omi-med-stt-v1'
+      | 'humain/realtime'
+      | 'reson8/turns'
+      | 'cohere/ar-stt'
+      | 'telnyx/basira'
+      | 'distil-whisper/distil-large-v2'
+      | 'openai/whisper-large-v3-turbo';
+
+    /**
+     * The language this model transcribes. Omit it or set it to `null` to use the
+     * language of `transcription.model`. The request is rejected when this model
+     * doesn't support the language it would run. It is also rejected when it would run
+     * the same model on the same language as `transcription.model`.
+     */
+    language?: string | null;
+
+    /**
+     * How the assistant picks the transcript it uses. The models are compared on how
+     * complete and confident their transcripts are, not on language, so the rules work
+     * best when both models understand the callers' language.
+     *
+     * - `best_turn` (default): both models transcribe the whole call. Each turn uses
+     *   the language booster's transcript only when it scores higher than the
+     *   transcript of `transcription.model` (clearly higher with non-streaming
+     *   models). With streaming models, `transcription.model` also decides when each
+     *   turn ends. Available for every pair.
+     * - `best_engine`: both models transcribe the first turns, then the call continues
+     *   alone on the model whose transcripts scored higher. If neither clearly leads,
+     *   `transcription.model` continues. Streaming models only.
+     * - `merge_words`: both models transcribe each utterance and their words are
+     *   merged, keeping Arabic and English spoken in the same sentence. Available only
+     *   for `telnyx/basira` with `cohere/ar-stt`, in either order. The pair runs on
+     *   the language that applies to `telnyx/basira` (its own, or that of
+     *   `transcription.model`), which must be Arabic (`ar` or an `ar-` locale),
+     *   `multi`, or `auto`.
+     */
+    rule?: 'best_turn' | 'best_engine' | 'merge_words';
+
+    /**
+     * Settings for the language booster, with the same fields and limits as
+     * `transcription.settings`. Fields that don't apply to this model's provider are
+     * dropped, and the provider's defaults fill in the rest. Omit it or set it to
+     * `null` to use the settings of `transcription.model` where they apply to this
+     * model.
+     */
+    settings?: AssistantsAPI.TranscriptionSettingsConfig | null;
+  }
+
+  /**
+   * A streaming speech-to-text model that takes over transcription when the model in
+   * use fails.
+   */
+  export interface FallbackModel {
+    /**
+     * The fallback model. It must be a streaming model other than
+     * `transcription.model` and the other fallbacks: `deepgram/flux`,
+     * `deepgram/nova-3`, `deepgram/nova-2`, `assemblyai/universal-3-5-pro` (or its
+     * legacy alias `assemblyai/universal-streaming`), `xai/grok-stt`,
+     * `soniox/stt-rt-v4`, `soniox/stt-rt-v5`, `humain/realtime`, or `reson8/turns`.
+     */
+    model:
+      | 'deepgram/flux'
+      | 'deepgram/nova-3'
+      | 'deepgram/nova-2'
+      | 'assemblyai/universal-3-5-pro'
+      | 'assemblyai/universal-streaming'
+      | 'xai/grok-stt'
+      | 'soniox/stt-rt-v4'
+      | 'soniox/stt-rt-v5'
+      | 'humain/realtime'
+      | 'reson8/turns';
+
+    /**
+     * The language the fallback transcribes. Omit it or set it to `null` to use the
+     * language of `transcription.model`. The request is rejected when the fallback
+     * model doesn't support the language it would run.
+     */
+    language?: string | null;
+
+    /**
+     * Settings for the fallback, with the same fields and limits as
+     * `transcription.settings`. Fields that don't apply to this model's provider are
+     * dropped, and the provider's defaults fill in the rest. Omit it or set it to
+     * `null` to use the settings of `transcription.model` where they apply to this
+     * model.
+     */
+    settings?: AssistantsAPI.TranscriptionSettingsConfig | null;
+  }
+}
+
 export interface TranscriptionSettingsConfig {
   /**
    * Available only for soniox/stt-rt-v4 and soniox/stt-rt-v5. A comma-separated list
@@ -4162,6 +4433,13 @@ export interface AssistantCreateParams {
    */
   a2a_agents?: Array<AssistantA2AAgent>;
 
+  /**
+   * Body param: **Beta:** Configuration for the Telnyx open-source avatar provider.
+   * Use one of the six stock avatars or an organization-owned custom avatar returned
+   * by the Avatars API. Supported backgrounds are office, studio, and reception.
+   */
+  avatar_settings?: AvatarSettingsRequest | null;
+
   /**
    * Body param: Conversation flow as supplied by API clients (create / update).
    *
@@ -4448,6 +4726,13 @@ export interface AssistantUpdateParams {
    */
   a2a_agents?: Array<AssistantA2AAgent>;
 
+  /**
+   * **Beta:** Configuration for the Telnyx open-source avatar provider. Use one of
+   * the six stock avatars or an organization-owned custom avatar returned by the
+   * Avatars API. Supported backgrounds are office, studio, and reception.
+   */
+  avatar_settings?: AvatarSettingsRequest | null;
+
   /**
    * Conversation flow as supplied by API clients (create / update).
    *
@@ -4779,6 +5064,7 @@ export declare namespace Assistants {
     type AssistantsList as AssistantsList,
     type AudioVisualizerConfig as AudioVisualizerConfig,
     type AuthenticationMethod as AuthenticationMethod,
+    type AvatarSettingsRequest as AvatarSettingsRequest,
     type BooleanOpExpression as BooleanOpExpression,
     type ComparisonExpression as ComparisonExpression,
     type ConversationFlow as ConversationFlow,
@@ -4815,6 +5101,7 @@ export declare namespace Assistants {
     type SpeakNodeReq as SpeakNodeReq,
     type StartSpeakingPlan as StartSpeakingPlan,
     type TelephonySettings as TelephonySettings,
+    type TelnyxAvatarSettings as TelnyxAvatarSettings,
     type ToolNode as ToolNode,
     type ToolNodeReq as ToolNodeReq,
     type TranscriptionEndpointingPlan as TranscriptionEndpointingPlan,

package/src/resources/ai/assistants/index.ts

@@ -11,6 +11,7 @@ export {
   type AssistantsList,
   type AudioVisualizerConfig,
   type AuthenticationMethod,
+  type AvatarSettingsRequest,
   type BooleanOpExpression,
   type ComparisonExpression,
   type ConversationFlow,
@@ -47,6 +48,7 @@ export {
   type SpeakNodeReq,
   type StartSpeakingPlan,
   type TelephonySettings,
+  type TelnyxAvatarSettings,
   type ToolNode,
   type ToolNodeReq,
   type TranscriptionEndpointingPlan,

package/src/resources/ai/assistants/versions.ts

@@ -130,6 +130,13 @@ export interface UpdateAssistant {
    */
   a2a_agents?: Array<AssistantsAPI.AssistantA2AAgent>;
 
+  /**
+   * **Beta:** Configuration for the Telnyx open-source avatar provider. Use one of
+   * the six stock avatars or an organization-owned custom avatar returned by the
+   * Avatars API. Supported backgrounds are office, studio, and reception.
+   */
+  avatar_settings?: AssistantsAPI.AvatarSettingsRequest | null;
+
   /**
    * Conversation flow as supplied by API clients (create / update).
    *
@@ -357,6 +364,13 @@ export interface VersionUpdateParams {
    */
   a2a_agents?: Array<AssistantsAPI.AssistantA2AAgent>;
 
+  /**
+   * Body param: **Beta:** Configuration for the Telnyx open-source avatar provider.
+   * Use one of the six stock avatars or an organization-owned custom avatar returned
+   * by the Avatars API. Supported backgrounds are office, studio, and reception.
+   */
+  avatar_settings?: AssistantsAPI.AvatarSettingsRequest | null;
+
   /**
    * Body param: Conversation flow as supplied by API clients (create / update).
    *