telnyx 6.40.0 → 6.41.1

package/src/resources/texml/accounts/calls/calls.ts

@@ -83,20 +83,13 @@ export class Calls extends APIResource {
    * ```ts
    * const response = await client.texml.accounts.calls.calls(
    *   'account_sid',
-   *   { Url: 'https://www.example.com/instructions.xml' },
+   *   { params: { Url: 'https://www.example.com/texml.xml' } },
    * );
    * ```
    */
-  calls(
-    accountSid: string,
-    params: CallCallsParams,
-    options?: RequestOptions,
-  ): APIPromise<CallCallsResponse> {
-    const { timeout_seconds, ...body } = params;
-    return this._client.post(path`/texml/Accounts/${accountSid}/Calls`, {
-      body: { Timeout: timeout_seconds, ...body },
-      ...options,
-    });
+  calls(accountSid: string, args: CallCallsParams, options?: RequestOptions): APIPromise<CallCallsResponse> {
+    const { params } = args;
+    return this._client.post(path`/texml/Accounts/${accountSid}/Calls`, { body: params, ...options });
   }
 
   /**
@@ -684,12 +677,11 @@ export interface CallUpdateParams {
   Url?: string;
 }
 
-export type CallCallsParams =
-  | CallCallsParams.WithURL
-  | CallCallsParams.WithTeXml
-  | CallCallsParams.ApplicationDefault;
+export interface CallCallsParams {
+  params: CallCallsParams.WithURL | CallCallsParams.WithTeXml | CallCallsParams.ApplicationDefault;
+}
 
-export declare namespace CallCallsParams {
+export namespace CallCallsParams {
   export interface WithURL {
     /**
      * The URL from which Telnyx will retrieve the TeXML call instructions.
@@ -891,7 +883,7 @@ export declare namespace CallCallsParams {
      */
     SupervisingRole?: 'barge' | 'whisper' | 'monitor';
 
-    Texml?: unknown;
+    Texml?: string | null;
 
     /**
      * The maximum duration of the call in seconds. The minimum value is 30 and the
@@ -904,7 +896,7 @@ export declare namespace CallCallsParams {
      * call is canceled. The minimum value is 5 and the maximum value is 120. Default
      * is 30 seconds.
      */
-    timeout_seconds?: number;
+    Timeout?: number;
 
     /**
      * The phone number of the called party. Phone numbers are formatted with a `+` and
@@ -1152,7 +1144,7 @@ export declare namespace CallCallsParams {
      * call is canceled. The minimum value is 5 and the maximum value is 120. Default
      * is 30 seconds.
      */
-    timeout_seconds?: number;
+    Timeout?: number;
 
     /**
      * The phone number of the called party. Phone numbers are formatted with a `+` and
@@ -1166,7 +1158,7 @@ export declare namespace CallCallsParams {
      */
     Trim?: 'trim-silence' | 'do-not-trim';
 
-    Url?: unknown;
+    Url?: string | null;
 
     /**
      * HTTP request type used for `Url`. The default value is inherited from TeXML
@@ -1385,7 +1377,7 @@ export declare namespace CallCallsParams {
      */
     SupervisingRole?: 'barge' | 'whisper' | 'monitor';
 
-    Texml?: unknown;
+    Texml?: string | null;
 
     /**
      * The maximum duration of the call in seconds. The minimum value is 30 and the
@@ -1398,7 +1390,7 @@ export declare namespace CallCallsParams {
      * call is canceled. The minimum value is 5 and the maximum value is 120. Default
      * is 30 seconds.
      */
-    timeout_seconds?: number;
+    Timeout?: number;
 
     /**
      * The phone number of the called party. Phone numbers are formatted with a `+` and
@@ -1412,7 +1404,7 @@ export declare namespace CallCallsParams {
      */
     Trim?: 'trim-silence' | 'do-not-trim';
 
-    Url?: unknown;
+    Url?: string | null;
 
     /**
      * HTTP request type used for `Url`. The default value is inherited from TeXML

package/src/resources/virtual-cross-connects.ts

@@ -522,7 +522,8 @@ export namespace VirtualCrossConnectUpdateResponse {
 }
 
 export interface VirtualCrossConnectListResponse
-  extends GlobalIPAssignmentsAPI.Record, PublicInternetGatewaysAPI.NetworkInterface {
+  extends GlobalIPAssignmentsAPI.Record,
+    PublicInternetGatewaysAPI.NetworkInterface {
   /**
    * The region interface is deployed to.
    */

package/src/resources/voice-clones.ts

@@ -20,15 +20,19 @@ export class VoiceClones extends APIResource {
    * @example
    * ```ts
    * const voiceClone = await client.voiceClones.create({
-   *   gender: 'male',
-   *   language: 'en',
-   *   name: 'clone-narrator',
-   *   voice_design_id: '550e8400-e29b-41d4-a716-446655440000',
+   *   params: {
+   *     gender: 'male',
+   *     language: 'en',
+   *     name: 'clone-narrator',
+   *     voice_design_id: '550e8400-e29b-41d4-a716-446655440000',
+   *     provider: 'telnyx',
+   *   },
    * });
    * ```
    */
-  create(body: VoiceCloneCreateParams, options?: RequestOptions): APIPromise<VoiceCloneCreateResponse> {
-    return this._client.post('/voice_clones', { body, ...options });
+  create(args: VoiceCloneCreateParams, options?: RequestOptions): APIPromise<VoiceCloneCreateResponse> {
+    const { params } = args;
+    return this._client.post('/voice_clones', { body: params, ...options });
   }
 
   /**
@@ -91,24 +95,29 @@ export class VoiceClones extends APIResource {
   /**
    * Creates a new voice clone by uploading an audio file directly. Supported
    * formats: WAV, MP3, FLAC, OGG, M4A. For best results, provide 5–10 seconds of
-   * clear speech. Maximum file size: 2MB.
+   * clear speech. Maximum file size: 5MB for Telnyx, 20MB for Minimax.
    *
    * @example
    * ```ts
    * const response = await client.voiceClones.createFromUpload({
-   *   audio_file: fs.createReadStream('path/to/file'),
-   *   language: 'lkf-Lz1vLbBu-9uDh-9AHaOS2D-Cbf',
-   *   name: 'name',
+   *   params: {
+   *     audio_file: fs.createReadStream('path/to/file'),
+   *     gender: 'male',
+   *     language: 'lkf-Lz1vLbBu-9uDh-9AHaOS2D-Cbf',
+   *     name: 'name',
+   *     provider: 'telnyx',
+   *   },
    * });
    * ```
    */
   createFromUpload(
-    body: VoiceCloneCreateFromUploadParams,
+    args: VoiceCloneCreateFromUploadParams,
     options?: RequestOptions,
   ): APIPromise<VoiceCloneCreateFromUploadResponse> {
+    const { params } = args;
     return this._client.post(
       '/voice_clones/from_upload',
-      multipartFormRequestOptions({ body, ...options }, this._client),
+      multipartFormRequestOptions({ body: params, ...options }, this._client),
     );
   }
 
@@ -166,6 +175,11 @@ export interface VoiceCloneData {
    */
   language?: string | null;
 
+  /**
+   * TTS model identifier for the voice clone.
+   */
+  model_id?: 'Qwen3TTS' | 'Ultra' | 'speech-2.8-turbo';
+
   /**
    * Name of the voice clone.
    */
@@ -182,8 +196,8 @@ export interface VoiceCloneData {
   provider_supported_models?: Array<string>;
 
   /**
-   * Provider-specific voice identifier used for TTS synthesis. For Telnyx clones
-   * this equals the clone ID; for Minimax it is the Minimax-assigned voice ID.
+   * Provider-specific voice identifier used for TTS synthesis. May differ from the
+   * clone UUID depending on the provider and model.
    */
   provider_voice_id?: string | null;
 
@@ -202,6 +216,12 @@ export interface VoiceCloneData {
    */
   source_voice_design_version?: number | null;
 
+  /**
+   * Clone status. pending for Ultra clones while on-prem import is in progress,
+   * active once ready, failed if verification timed out, expired if not kept alive.
+   */
+  status?: 'active' | 'pending' | 'failed' | 'expired';
+
   /**
    * Timestamp when the voice clone was last updated.
    */
@@ -240,29 +260,72 @@ export interface VoiceCloneCreateFromUploadResponse {
 
 export interface VoiceCloneCreateParams {
   /**
-   * Gender of the voice clone.
+   * Request body for creating a voice clone from an existing voice design.
    */
-  gender: 'male' | 'female' | 'neutral';
+  params: VoiceCloneCreateParams.TelnyxDesignClone | VoiceCloneCreateParams.MinimaxDesignClone;
+}
 
+export namespace VoiceCloneCreateParams {
   /**
-   * ISO 639-1 language code for the clone (e.g. `en`, `fr`, `de`).
+   * Create a voice clone from a voice design using the Telnyx provider.
    */
-  language: string;
+  export interface TelnyxDesignClone {
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
 
-  /**
-   * Name for the voice clone.
-   */
-  name: string;
+    /**
+     * ISO 639-1 language code for the clone. Supports the combined Telnyx language
+     * set.
+     */
+    language: string;
 
-  /**
-   * UUID of the source voice design to clone.
-   */
-  voice_design_id: string;
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+
+    /**
+     * UUID of the source voice design to clone.
+     */
+    voice_design_id: string;
+
+    /**
+     * Voice synthesis provider. Defaults to `telnyx`.
+     */
+    provider?: 'telnyx' | 'minimax';
+  }
 
   /**
-   * Voice synthesis provider. Case-insensitive. Defaults to `telnyx`.
+   * Create a voice clone from a voice design using the Minimax provider.
    */
-  provider?: 'telnyx' | 'minimax';
+  export interface MinimaxDesignClone {
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
+
+    /**
+     * ISO 639-1 language code for the clone. Supports the Minimax language set.
+     */
+    language: string;
+
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+
+    /**
+     * Voice synthesis provider. Must be `minimax`.
+     */
+    provider: 'telnyx' | 'minimax';
+
+    /**
+     * UUID of the source voice design to clone.
+     */
+    voice_design_id: string;
+  }
 }
 
 export interface VoiceCloneUpdateParams {
@@ -301,42 +364,156 @@ export interface VoiceCloneListParams extends DefaultFlatPaginationParams {
 
 export interface VoiceCloneCreateFromUploadParams {
   /**
-   * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
-   * For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum
-   * size: 5MB for Telnyx, 20MB for Minimax.
+   * Multipart form data for creating a voice clone from a direct audio upload.
+   * Maximum file size: 5MB for Telnyx, 20MB for Minimax.
    */
-  audio_file: Uploadable;
-
-  /**
-   * ISO 639-1 language code (e.g. `en`, `fr`) or `auto` for automatic detection.
-   */
-  language: string;
-
-  /**
-   * Name for the voice clone.
-   */
-  name: string;
-
-  /**
-   * Gender of the voice clone.
-   */
-  gender?: 'male' | 'female' | 'neutral';
+  params:
+    | VoiceCloneCreateFromUploadParams.TelnyxQwen3TtsClone
+    | VoiceCloneCreateFromUploadParams.TelnyxUltraClone
+    | VoiceCloneCreateFromUploadParams.MinimaxClone;
+}
 
-  /**
-   * Optional custom label describing the voice style. If omitted, falls back to the
-   * source design's prompt text.
-   */
-  label?: string;
+export namespace VoiceCloneCreateFromUploadParams {
+  /**
+   * Upload-based voice clone using the Telnyx Qwen3TTS model (default).
+   */
+  export interface TelnyxQwen3TtsClone {
+    /**
+     * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
+     * For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum
+     * size: 5MB.
+     */
+    audio_file: Uploadable;
+
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
+
+    /**
+     * ISO 639-1 language code from the Qwen language set.
+     */
+    language: string;
+
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+
+    /**
+     * Voice synthesis provider. Must be `telnyx`.
+     */
+    provider: 'telnyx' | 'minimax';
+
+    /**
+     * Optional custom label describing the voice style.
+     */
+    label?: string;
+
+    /**
+     * TTS model identifier. Nullable/omittable — defaults to Qwen3TTS.
+     */
+    model_id?: 'Qwen3TTS' | null;
+
+    /**
+     * Optional transcript of the audio file. Providing this improves clone quality.
+     */
+    ref_text?: string;
+  }
 
   /**
-   * Voice synthesis provider. Case-insensitive. Defaults to `telnyx`.
-   */
-  provider?: 'telnyx' | 'minimax';
+   * Upload-based voice clone using the Telnyx Ultra model.
+   */
+  export interface TelnyxUltraClone {
+    /**
+     * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
+     * For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum
+     * size: 5MB.
+     */
+    audio_file: Uploadable;
+
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
+
+    /**
+     * ISO 639-1 language code from the Ultra language set (40 languages).
+     */
+    language: string;
+
+    /**
+     * TTS model identifier. Must be `Ultra`.
+     */
+    model_id: 'Ultra';
+
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+
+    /**
+     * Voice synthesis provider. Must be `telnyx`.
+     */
+    provider: 'telnyx' | 'minimax';
+
+    /**
+     * Optional custom label describing the voice style.
+     */
+    label?: string;
+
+    /**
+     * Optional transcript of the audio file. Providing this improves clone quality.
+     */
+    ref_text?: string;
+  }
 
   /**
-   * Optional transcript of the audio file. Providing this improves clone quality.
-   */
-  ref_text?: string;
+   * Upload-based voice clone using the Minimax provider.
+   */
+  export interface MinimaxClone {
+    /**
+     * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
+     * For best quality, provide 5–10 seconds of clear, uninterrupted speech. Maximum
+     * size: 20MB.
+     */
+    audio_file: Uploadable;
+
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
+
+    /**
+     * ISO 639-1 language code from the Minimax language set.
+     */
+    language: string;
+
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+
+    /**
+     * Voice synthesis provider. Must be `minimax`.
+     */
+    provider: 'telnyx' | 'minimax';
+
+    /**
+     * Optional custom label describing the voice style.
+     */
+    label?: string;
+
+    /**
+     * TTS model identifier. Nullable — defaults to speech-2.8-turbo.
+     */
+    model_id?: 'speech-2.8-turbo' | null;
+
+    /**
+     * Optional transcript of the audio file. Providing this improves clone quality.
+     */
+    ref_text?: string;
+  }
 }
 
 export declare namespace VoiceClones {

package/src/resources/whatsapp/phone-numbers/profile/index.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { Photo, type PhotoUploadResponse, type PhotoUploadParams } from './photo';
+export { Photo, type PhotoRetrieveResponse, type PhotoUploadResponse, type PhotoUploadParams } from './photo';
 export {
   Profile,
   type WhatsappProfileData,

package/src/resources/whatsapp/phone-numbers/profile/photo.ts

@@ -13,6 +13,21 @@ import { path } from '../../../../internal/utils/path';
  * Manage Whatsapp phone numbers
  */
 export class Photo extends APIResource {
+  /**
+   * Get Whatsapp profile photo
+   *
+   * @example
+   * ```ts
+   * const photo =
+   *   await client.whatsapp.phoneNumbers.profile.photo.retrieve(
+   *     'phone_number',
+   *   );
+   * ```
+   */
+  retrieve(phoneNumber: string, options?: RequestOptions): APIPromise<PhotoRetrieveResponse> {
+    return this._client.get(path`/v2/whatsapp/phone_numbers/${phoneNumber}/profile/photo`, options);
+  }
+
   /**
    * Delete Whatsapp profile photo
    *
@@ -54,6 +69,27 @@ export class Photo extends APIResource {
   }
 }
 
+export interface PhotoRetrieveResponse {
+  data?: PhotoRetrieveResponse.Data;
+}
+
+export namespace PhotoRetrieveResponse {
+  export interface Data {
+    /**
+     * Meta phone number ID
+     */
+    phone_number_id?: string;
+
+    /**
+     * URL of the business profile photo (served by Meta's CDN). May be empty if no
+     * photo is set.
+     */
+    profile_photo_url?: string;
+
+    record_type?: string;
+  }
+}
+
 export interface PhotoUploadResponse {
   data?: ProfileAPI.WhatsappProfileData;
 }
@@ -66,5 +102,9 @@ export interface PhotoUploadParams {
 }
 
 export declare namespace Photo {
-  export { type PhotoUploadResponse as PhotoUploadResponse, type PhotoUploadParams as PhotoUploadParams };
+  export {
+    type PhotoRetrieveResponse as PhotoRetrieveResponse,
+    type PhotoUploadResponse as PhotoUploadResponse,
+    type PhotoUploadParams as PhotoUploadParams,
+  };
 }

package/src/resources/whatsapp/phone-numbers/profile/profile.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../../../core/resource';
 import * as PhotoAPI from './photo';
-import { Photo, PhotoUploadParams, PhotoUploadResponse } from './photo';
+import { Photo, PhotoRetrieveResponse, PhotoUploadParams, PhotoUploadResponse } from './photo';
 import { APIPromise } from '../../../../core/api-promise';
 import { RequestOptions } from '../../../../internal/request-options';
 import { path } from '../../../../internal/utils/path';
@@ -115,6 +115,7 @@ export declare namespace Profile {
 
   export {
     Photo as Photo,
+    type PhotoRetrieveResponse as PhotoRetrieveResponse,
     type PhotoUploadResponse as PhotoUploadResponse,
     type PhotoUploadParams as PhotoUploadParams,
   };

package/src/resources/wireguard-interfaces.ts

@@ -186,7 +186,8 @@ export namespace WireguardInterfaceRetrieveResponse {
 }
 
 export interface WireguardInterfaceListResponse
-  extends GlobalIPAssignmentsAPI.Record, PublicInternetGatewaysAPI.NetworkInterface {
+  extends GlobalIPAssignmentsAPI.Record,
+    PublicInternetGatewaysAPI.NetworkInterface {
   /**
    * Enable SIP traffic forwarding over VPN interface.
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '6.40.0'; // x-release-please-version
+export const VERSION = '6.41.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.40.0";
+export declare const VERSION = "6.41.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.40.0";
+export declare const VERSION = "6.41.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '6.40.0'; // x-release-please-version
+exports.VERSION = '6.41.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '6.40.0'; // x-release-please-version
+export const VERSION = '6.41.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map