telnyx 7.21.0 → 7.23.0

package/src/resources/messaging-profiles/messaging-profiles.ts

@@ -273,6 +273,13 @@ export interface MessagingMessagingProfile {
    */
   enabled?: boolean;
 
+  /**
+   * Telnyx product features the messaging customer can enable on the messaging
+   * profile. Keys map to individual feature flags; unknown keys are accepted and
+   * preserved for forward compatibility with rolling deployments.
+   */
+  features?: MessagingProfileFeatures | null;
+
   /**
    * DEPRECATED: health check url service checking
    */
@@ -543,6 +550,23 @@ export interface MessagingProfile {
   whitelisted_destinations?: Array<string>;
 }
 
+/**
+ * Telnyx product features the messaging customer can enable on the messaging
+ * profile. Keys map to individual feature flags; unknown keys are accepted and
+ * preserved for forward compatibility with rolling deployments.
+ */
+export interface MessagingProfileFeatures {
+  /**
+   * Enables AI detection of inbound opt-out messages that do not follow the standard
+   * STOP/UNSTOP/HELP opt-out keyword pattern. When enabled, the messaging platform
+   * applies an AI model to identify non-standard opt-out requests (e.g.
+   * natural-language phrases) and treats them as opt-outs.
+   */
+  ai_opt_out_detection_enabled?: boolean;
+
+  [k: string]: unknown;
+}
+
 /**
  * Number Pool allows you to send messages from a pool of numbers of different
  * types, assigning weights to each type. The pool consists of all the long code
@@ -720,6 +744,13 @@ export interface MessagingProfileCreateParams {
    */
   enabled?: boolean;
 
+  /**
+   * Telnyx product features the messaging customer can enable on the messaging
+   * profile. Keys map to individual feature flags; unknown keys are accepted and
+   * preserved for forward compatibility with rolling deployments.
+   */
+  features?: MessagingProfileFeatures | null;
+
   /**
    * A URL to receive health check webhooks for numbers in this profile.
    */
@@ -818,6 +849,13 @@ export interface MessagingProfileUpdateParams {
    */
   enabled?: boolean;
 
+  /**
+   * Telnyx product features the messaging customer can enable on the messaging
+   * profile. Keys map to individual feature flags; unknown keys are accepted and
+   * preserved for forward compatibility with rolling deployments.
+   */
+  features?: MessagingProfileFeatures | null;
+
   /**
    * enables SMS fallback for MMS messages.
    */
@@ -932,6 +970,7 @@ export declare namespace MessagingProfiles {
   export {
     type MessagingMessagingProfile as MessagingMessagingProfile,
     type MessagingProfile as MessagingProfile,
+    type MessagingProfileFeatures as MessagingProfileFeatures,
     type NumberPoolSettings as NumberPoolSettings,
     type URLShortenerSettings as URLShortenerSettings,
     type MessagingProfileCreateResponse as MessagingProfileCreateResponse,

package/src/resources/noise-suppression-engines.ts

@@ -0,0 +1,51 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+/**
+ * Noise suppression engines that can be selected when configuring noise suppression on voice connections.
+ */
+export class NoiseSuppressionEngines extends APIResource {
+  /**
+   * Returns all noise suppression engines available to the authenticated user.
+   * Engines gated behind a feature flag are included only when the flag is enabled
+   * for the user's account. Results are not paginated; the number of engines is
+   * expected to remain small.
+   */
+  list(options?: RequestOptions): APIPromise<NoiseSuppressionEngineListResponse> {
+    return this._client.get('/noise_suppression_engines', options);
+  }
+}
+
+export interface NoiseSuppressionEngineListResponse {
+  data: Array<NoiseSuppressionEngineListResponse.Data>;
+}
+
+export namespace NoiseSuppressionEngineListResponse {
+  /**
+   * A noise suppression engine available to the authenticated user.
+   */
+  export interface Data {
+    /**
+     * Default attenuation level of the engine (0-100, in multiples of ten).
+     */
+    default_attenuation_level: number;
+
+    /**
+     * Human-readable name of the engine.
+     */
+    label: string;
+
+    /**
+     * Machine-readable identifier of the engine, used when configuring noise
+     * suppression.
+     */
+    value: string;
+  }
+}
+
+export declare namespace NoiseSuppressionEngines {
+  export { type NoiseSuppressionEngineListResponse as NoiseSuppressionEngineListResponse };
+}

package/src/resources/speech-to-text/speech-to-text.ts

@@ -314,6 +314,7 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'speechmatics/standard'
     | 'soniox/stt-rt-v4'
     | 'nvidia/parakeet-v3'
+    | 'omi-health/omi-med-stt-v1'
     | 'humain/realtime'
     | 'reson8/turns'
     | 'cohere/ar-stt';

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

@@ -590,6 +590,27 @@ export namespace CallCallsParams {
      */
     MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
 
+    /**
+     * Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+     * Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepMaxFrequency?: number;
+
+    /**
+     * Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+     * it above 480 excludes North American ringback (440 + 480 Hz), which can
+     * otherwise be reported as a beep when the `freq_only` profile is in use. Only
+     * used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepMinFrequency?: number;
+
+    /**
+     * Shortest tone, in milliseconds, that can be treated as a beep. Raising it
+     * rejects brief tones such as call-progress blips. Only used when MachineDetection
+     * is enabled.
+     */
+    MachineDetectionBeepMinToneDuration?: number;
+
     /**
      * Selects which detectors must validate a beep. `both` requires the amplitude and
      * frequency detectors to agree. `freq_only` uses the frequency detector alone, for
@@ -598,6 +619,31 @@ export namespace CallCallsParams {
      */
     MachineDetectionBeepProfile?: 'both' | 'freq_only';
 
+    /**
+     * When enabled, a candidate beep must pass an additional spectral check before it
+     * is reported. Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralConfirmation?: boolean;
+
+    /**
+     * Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep.
+     * Raising it rejects mixed tones such as ringback, which combines two frequencies.
+     * Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralMinPurity?: number;
+
+    /**
+     * When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+     * used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralRejectFaxCng?: boolean;
+
+    /**
+     * Length of the spectral confirmation window, in milliseconds. Only used when
+     * MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralWindow?: number;
+
     /**
      * Silence duration threshold after a call screening prompt before ending prompt
      * detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.
@@ -874,6 +920,27 @@ export namespace CallCallsParams {
      */
     MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
 
+    /**
+     * Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+     * Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepMaxFrequency?: number;
+
+    /**
+     * Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+     * it above 480 excludes North American ringback (440 + 480 Hz), which can
+     * otherwise be reported as a beep when the `freq_only` profile is in use. Only
+     * used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepMinFrequency?: number;
+
+    /**
+     * Shortest tone, in milliseconds, that can be treated as a beep. Raising it
+     * rejects brief tones such as call-progress blips. Only used when MachineDetection
+     * is enabled.
+     */
+    MachineDetectionBeepMinToneDuration?: number;
+
     /**
      * Selects which detectors must validate a beep. `both` requires the amplitude and
      * frequency detectors to agree. `freq_only` uses the frequency detector alone, for
@@ -882,6 +949,31 @@ export namespace CallCallsParams {
      */
     MachineDetectionBeepProfile?: 'both' | 'freq_only';
 
+    /**
+     * When enabled, a candidate beep must pass an additional spectral check before it
+     * is reported. Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralConfirmation?: boolean;
+
+    /**
+     * Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep.
+     * Raising it rejects mixed tones such as ringback, which combines two frequencies.
+     * Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralMinPurity?: number;
+
+    /**
+     * When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+     * used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralRejectFaxCng?: boolean;
+
+    /**
+     * Length of the spectral confirmation window, in milliseconds. Only used when
+     * MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralWindow?: number;
+
     /**
      * Silence duration threshold after a call screening prompt before ending prompt
      * detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.
@@ -1152,6 +1244,27 @@ export namespace CallCallsParams {
      */
     MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
 
+    /**
+     * Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+     * Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepMaxFrequency?: number;
+
+    /**
+     * Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+     * it above 480 excludes North American ringback (440 + 480 Hz), which can
+     * otherwise be reported as a beep when the `freq_only` profile is in use. Only
+     * used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepMinFrequency?: number;
+
+    /**
+     * Shortest tone, in milliseconds, that can be treated as a beep. Raising it
+     * rejects brief tones such as call-progress blips. Only used when MachineDetection
+     * is enabled.
+     */
+    MachineDetectionBeepMinToneDuration?: number;
+
     /**
      * Selects which detectors must validate a beep. `both` requires the amplitude and
      * frequency detectors to agree. `freq_only` uses the frequency detector alone, for
@@ -1160,6 +1273,31 @@ export namespace CallCallsParams {
      */
     MachineDetectionBeepProfile?: 'both' | 'freq_only';
 
+    /**
+     * When enabled, a candidate beep must pass an additional spectral check before it
+     * is reported. Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralConfirmation?: boolean;
+
+    /**
+     * Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep.
+     * Raising it rejects mixed tones such as ringback, which combines two frequencies.
+     * Only used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralMinPurity?: number;
+
+    /**
+     * When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+     * used when MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralRejectFaxCng?: boolean;
+
+    /**
+     * Length of the spectral confirmation window, in milliseconds. Only used when
+     * MachineDetection is enabled.
+     */
+    MachineDetectionBeepSpectralWindow?: number;
+
     /**
      * Silence duration threshold after a call screening prompt before ending prompt
      * detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.

package/src/resources/texml/accounts/conferences/participants.ts

@@ -484,6 +484,27 @@ export interface ParticipantParticipantsParams {
    */
   MachineDetection?: 'Enable' | 'DetectMessageEnd';
 
+  /**
+   * Body param: Highest frequency, in Hz, that a tone can reach and still be treated
+   * as a beep. Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepMaxFrequency?: number;
+
+  /**
+   * Body param: Lowest frequency, in Hz, that a tone must reach to be treated as a
+   * beep. Raising it above 480 excludes North American ringback (440 + 480 Hz),
+   * which can otherwise be reported as a beep when the `freq_only` profile is in
+   * use. Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepMinFrequency?: number;
+
+  /**
+   * Body param: Shortest tone, in milliseconds, that can be treated as a beep.
+   * Raising it rejects brief tones such as call-progress blips. Only used when
+   * MachineDetection is enabled.
+   */
+  MachineDetectionBeepMinToneDuration?: number;
+
   /**
    * Body param: Selects which detectors must validate a beep. `both` requires the
    * amplitude and frequency detectors to agree. `freq_only` uses the frequency
@@ -492,6 +513,31 @@ export interface ParticipantParticipantsParams {
    */
   MachineDetectionBeepProfile?: 'both' | 'freq_only';
 
+  /**
+   * Body param: When enabled, a candidate beep must pass an additional spectral
+   * check before it is reported. Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralConfirmation?: boolean;
+
+  /**
+   * Body param: Minimum spectral purity, from 0 to 1, for a tone to be treated as a
+   * beep. Raising it rejects mixed tones such as ringback, which combines two
+   * frequencies. Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralMinPurity?: number;
+
+  /**
+   * Body param: When enabled, the fax CNG tone is rejected rather than reported as a
+   * beep. Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralRejectFaxCng?: boolean;
+
+  /**
+   * Body param: Length of the spectral confirmation window, in milliseconds. Only
+   * used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralWindow?: number;
+
   /**
    * Body param: If initial silence duration is greater than this value, consider it
    * a machine. Ignored when `premium` detection is used.

package/src/resources/texml/calls.ts

@@ -0,0 +1,90 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * TeXML REST Commands
+ */
+export class Calls extends APIResource {
+  /**
+   * Initiate an outbound TeXML call using a TeXML application connection ID, not an
+   * account SID. Request parameter names are case-sensitive. From and To are
+   * required; Texml supplies inline instructions and Url overrides the application
+   * XML request URL. When neither is supplied, the application configuration
+   * supplies the instructions. The response is a flat call object without a data
+   * wrapper.
+   *
+   * @example
+   * ```ts
+   * const call = await client.texml.calls.create('1234567890', {
+   *   From: '+13120001234',
+   *   To: '+13121230000',
+   *   Texml: '<Response><Say>Hello</Say></Response>',
+   * });
+   * ```
+   */
+  create(
+    connectionID: string,
+    body: CallCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<CallCreateResponse> {
+    return this._client.post(path`/texml/calls/${connectionID}`, { body, ...options });
+  }
+}
+
+export interface CallCreateResponse {
+  /**
+   * The call control ID of the created call.
+   */
+  call_sid: string;
+
+  /**
+   * The caller address.
+   */
+  from: string;
+
+  /**
+   * The initial status of the outbound call.
+   */
+  status: 'queued';
+
+  /**
+   * The called address.
+   */
+  to: string;
+}
+
+export interface CallCreateParams {
+  /**
+   * The E.164-formatted phone number or SIP URI to present as the caller.
+   */
+  From: string;
+
+  /**
+   * The E.164-formatted phone number or SIP URI to call.
+   */
+  To: string;
+
+  /**
+   * HTTP method used to retrieve TeXML instructions from Url.
+   */
+  Method?: 'GET' | 'POST';
+
+  /**
+   * Inline TeXML instructions to execute when the call is answered.
+   */
+  Texml?: string;
+
+  /**
+   * The URL from which to retrieve TeXML instructions. Overrides the TeXML
+   * application XML request URL.
+   */
+  Url?: string;
+}
+
+export declare namespace Calls {
+  export { type CallCreateResponse as CallCreateResponse, type CallCreateParams as CallCreateParams };
+}

package/src/resources/texml/index.ts

@@ -8,6 +8,7 @@ export {
   type AccountRetrieveRecordingsJsonParams,
   type AccountRetrieveTranscriptionsJsonParams,
 } from './accounts/index';
+export { Calls, type CallCreateResponse, type CallCreateParams } from './calls';
 export {
   Texml,
   type TexmlInitiateAICallResponse,

package/src/resources/texml/texml.ts

@@ -1,6 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as CallsAPI from './calls';
+import { CallCreateParams, CallCreateResponse, Calls } from './calls';
 import * as AccountsAPI from './accounts/accounts';
 import {
   AccountRetrieveRecordingsJsonParams,
@@ -18,6 +20,7 @@ import { path } from '../../internal/utils/path';
  * TeXML REST Commands
  */
 export class Texml extends APIResource {
+  calls: CallsAPI.Calls = new CallsAPI.Calls(this._client);
   accounts: AccountsAPI.Accounts = new AccountsAPI.Accounts(this._client);
 
   /**
@@ -203,6 +206,27 @@ export interface TexmlInitiateAICallParams {
    */
   MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
 
+  /**
+   * Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+   * Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepMaxFrequency?: number;
+
+  /**
+   * Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+   * it above 480 excludes North American ringback (440 + 480 Hz), which can
+   * otherwise be reported as a beep when the `freq_only` profile is in use. Only
+   * used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepMinFrequency?: number;
+
+  /**
+   * Shortest tone, in milliseconds, that can be treated as a beep. Raising it
+   * rejects brief tones such as call-progress blips. Only used when MachineDetection
+   * is enabled.
+   */
+  MachineDetectionBeepMinToneDuration?: number;
+
   /**
    * Selects which detectors must validate a beep. `both` requires the amplitude and
    * frequency detectors to agree. `freq_only` uses the frequency detector alone, for
@@ -211,6 +235,31 @@ export interface TexmlInitiateAICallParams {
    */
   MachineDetectionBeepProfile?: 'both' | 'freq_only';
 
+  /**
+   * When enabled, a candidate beep must pass an additional spectral check before it
+   * is reported. Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralConfirmation?: boolean;
+
+  /**
+   * Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep.
+   * Raising it rejects mixed tones such as ringback, which combines two frequencies.
+   * Only used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralMinPurity?: number;
+
+  /**
+   * When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+   * used when MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralRejectFaxCng?: boolean;
+
+  /**
+   * Length of the spectral confirmation window, in milliseconds. Only used when
+   * MachineDetection is enabled.
+   */
+  MachineDetectionBeepSpectralWindow?: number;
+
   /**
    * Silence duration threshold after a call screening prompt before ending prompt
    * detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.
@@ -373,6 +422,7 @@ export namespace TexmlInitiateAICallParams {
   }
 }
 
+Texml.Calls = Calls;
 Texml.Accounts = Accounts;
 
 export declare namespace Texml {
@@ -383,6 +433,12 @@ export declare namespace Texml {
     type TexmlInitiateAICallParams as TexmlInitiateAICallParams,
   };
 
+  export {
+    Calls as Calls,
+    type CallCreateResponse as CallCreateResponse,
+    type CallCreateParams as CallCreateParams,
+  };
+
   export {
     Accounts as Accounts,
     type TexmlGetCallRecordingResponseBody as TexmlGetCallRecordingResponseBody,

package/src/resources/uac-connections/uac-connections.ts

@@ -247,7 +247,10 @@ export interface UacConnection {
 
   /**
    * The password to be used as part of the credentials. Must be 8 to 128 characters
-   * long.
+   * long. For primary accounts created on or after September 8, 2026, this password
+   * is returned as `********`. The password is returned in full on create, and on
+   * update only when that update changed the password. Accounts created before
+   * September 8, 2026 are unaffected.
    */
   password?: string;
 
@@ -348,7 +351,11 @@ export interface UacExternalSettings {
   outbound_proxy?: string | null;
 
   /**
-   * The SIP password used for digest authentication with the external SIP peer.
+   * The SIP password used for digest authentication with the external SIP peer. For
+   * primary accounts created on or after September 8, 2026, this password is
+   * returned as `********`. The password is returned in full on create, and on
+   * update only when that update changed the password. Accounts created before
+   * September 8, 2026 are unaffected.
    */
   password?: string;
 

package/src/resources/voice-clones.ts

@@ -58,8 +58,10 @@ 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: 5MB for Telnyx, 20MB for Minimax.
+   * formats: WAV, MP3, FLAC, OGG, M4A. For best results, provide 5–60 seconds of
+   * clear speech (Ultra accepts up to 60 seconds; Qwen3TTS auto-trims to 10 seconds;
+   * Minimax accepts up to 5 minutes). Maximum file size: 5MB for Telnyx, 20MB for
+   * Minimax.
    *
    * @example
    * ```ts
@@ -412,8 +414,8 @@ export namespace VoiceCloneCreateFromUploadParams {
   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.
+     * For best quality, provide up to 60 seconds of clear, uninterrupted speech.
+     * Maximum size: 5MB.
      */
     audio_file: Uploadable;