telnyx 7.26.0 → 7.27.0

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

@@ -22,7 +22,9 @@ export class Queues extends APIResource {
    * @example
    * ```ts
    * const queueResource =
-   *   await client.texml.accounts.queues.create('account_sid');
+   *   await client.texml.accounts.queues.create(
+   *     'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
+   *   );
    * ```
    */
   create(accountSid: string, body: QueueCreateParams, options?: RequestOptions): APIPromise<QueueResource> {
@@ -39,7 +41,7 @@ export class Queues extends APIResource {
    * @example
    * ```ts
    * await client.texml.accounts.queues.delete('queue_sid', {
-   *   account_sid: 'account_sid',
+   *   account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    * });
    * ```
    */
@@ -58,7 +60,7 @@ export class Queues extends APIResource {
    * ```ts
    * const queueResource =
    *   await client.texml.accounts.queues.retrieve('queue_sid', {
-   *     account_sid: 'account_sid',
+   *     account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   });
    * ```
    */
@@ -78,7 +80,7 @@ export class Queues extends APIResource {
    * ```ts
    * const queueResource =
    *   await client.texml.accounts.queues.update('queue_sid', {
-   *     account_sid: 'account_sid',
+   *     account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    *   });
    * ```
    */
@@ -99,7 +101,7 @@ export class Queues extends APIResource {
    * ```ts
    * // Automatically fetches more pages as needed.
    * for await (const queueResource of client.texml.accounts.queues.list(
-   *   'account_sid',
+   *   'f5586561-8ff0-4291-a51b-c7dfe4139ff9',
    * )) {
    *   // ...
    * }
@@ -181,21 +183,36 @@ export interface QueueCreateParams {
 
 export interface QueueDeleteParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface QueueRetrieveParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface QueueUpdateParams {
   /**
-   * Path param: The id of the account the resource belongs to.
+   * Path param: The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 

package/src/resources/texml/accounts/recordings/json.ts

@@ -18,7 +18,7 @@ export class Json extends APIResource {
    * ```ts
    * await client.texml.accounts.recordings.json.deleteRecordingSidJson(
    *   '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *   { account_sid: 'account_sid' },
+   *   { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    * );
    * ```
    */
@@ -42,7 +42,7 @@ export class Json extends APIResource {
    * const texmlGetCallRecordingResponseBody =
    *   await client.texml.accounts.recordings.json.retrieveRecordingSidJson(
    *     '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -58,14 +58,24 @@ export class Json extends APIResource {
 
 export interface JsonDeleteRecordingSidJsonParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface JsonRetrieveRecordingSidJsonParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }

package/src/resources/texml/accounts/transcriptions/json.ts

@@ -17,7 +17,7 @@ export class Json extends APIResource {
    * ```ts
    * await client.texml.accounts.transcriptions.json.deleteRecordingTranscriptionSidJson(
    *   '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *   { account_sid: 'account_sid' },
+   *   { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    * );
    * ```
    */
@@ -41,7 +41,7 @@ export class Json extends APIResource {
    * const texmlRecordingTranscription =
    *   await client.texml.accounts.transcriptions.json.retrieveRecordingTranscriptionSidJson(
    *     '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *     { account_sid: 'account_sid' },
+   *     { account_sid: 'f5586561-8ff0-4291-a51b-c7dfe4139ff9' },
    *   );
    * ```
    */
@@ -106,14 +106,24 @@ export interface TexmlRecordingTranscription {
 
 export interface JsonDeleteRecordingTranscriptionSidJsonParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }
 
 export interface JsonRetrieveRecordingTranscriptionSidJsonParams {
   /**
-   * The id of the account the resource belongs to.
+   * The UUID of the Telnyx account that owns the resource, for example
+   * `f5586561-8ff0-4291-a51b-c7dfe4139ff9`. The `account_sid` path segment is kept
+   * for Twilio API compatibility, but the value is a Telnyx account UUID, not a
+   * Twilio `AC...` SID. It must match the account that owns the API key used to
+   * authenticate the request, otherwise the endpoint returns `404`. The same value
+   * is sent as `AccountSid` in TeXML webhooks.
    */
   account_sid: string;
 }

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

@@ -410,7 +410,10 @@ export interface TextToSpeechGenerateSpeechParams {
   /**
    * Telnyx provider-specific parameters. For the `Ultra` model, use `voice_speed`,
    * `volume`, and `emotion`. `Bayan` and `Sukhan` don't use `temperature`, `volume`,
-   * or `emotion`, and don't support `voice_speed`. `Sukhan`'s `response_format` is
+   * or `emotion`. `Bayan` accepts `voice_speed` from 0.5 to 2.0; `Sukhan` doesn't
+   * support it. `Bayan` synthesizes at a native 16 kHz: `sampling_rate` `8000`,
+   * `22050`, or `24000` is resampled, needs `response_format: pcm`, and isn't
+   * available with `output_type: audio_id`. `Sukhan`'s `response_format` is
    * restricted to `mp3` or `pcm` (no `wav`).
    */
   telnyx?: TextToSpeechGenerateSpeechParams.Telnyx;
@@ -662,7 +665,10 @@ export namespace TextToSpeechGenerateSpeechParams {
   /**
    * Telnyx provider-specific parameters. For the `Ultra` model, use `voice_speed`,
    * `volume`, and `emotion`. `Bayan` and `Sukhan` don't use `temperature`, `volume`,
-   * or `emotion`, and don't support `voice_speed`. `Sukhan`'s `response_format` is
+   * or `emotion`. `Bayan` accepts `voice_speed` from 0.5 to 2.0; `Sukhan` doesn't
+   * support it. `Bayan` synthesizes at a native 16 kHz: `sampling_rate` `8000`,
+   * `22050`, or `24000` is resampled, needs `response_format: pcm`, and isn't
+   * available with `output_type: audio_id`. `Sukhan`'s `response_format` is
    * restricted to `mp3` or `pcm` (no `wav`).
    */
   export interface Telnyx {
@@ -678,15 +684,18 @@ export namespace TextToSpeechGenerateSpeechParams {
     response_format?: string;
 
     /**
-     * Audio sampling rate in Hz.
+     * Audio sampling rate in Hz. `Bayan` ignores the default and synthesizes at its
+     * native 16 kHz unless `8000`, `22050`, or `24000` is set explicitly with
+     * `response_format: pcm`. Resampled rates aren't available with
+     * `output_type: audio_id`.
      */
     sampling_rate?: number;
 
     /**
      * Voice speed multiplier. Telnyx `Ultra` voices accept values from 0.6 to 1.5 —
-     * requests outside that range are rejected by the synthesis engine. `KokoroTTS`
-     * and `Qwen3TTS` accept the field but do not apply it. `Bayan` and `Sukhan` don't
-     * support it.
+     * requests outside that range are rejected by the synthesis engine. `Bayan`
+     * accepts values from 0.5 to 2.0. `KokoroTTS` and `Qwen3TTS` accept the field but
+     * do not apply it. `Sukhan` doesn't support it.
      */
     voice_speed?: number;
 

package/src/resources/tts-integrations/actions.ts

@@ -0,0 +1,5 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+
+export class Actions extends APIResource {}

package/src/resources/tts-integrations/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Actions } from './actions';
+export { TtsIntegrations } from './tts-integrations';

package/src/resources/tts-integrations/tts-integrations.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ActionsAPI from './actions';
+import { Actions } from './actions';
+
+export class TtsIntegrations extends APIResource {
+  actions: ActionsAPI.Actions = new ActionsAPI.Actions(this._client);
+}
+
+TtsIntegrations.Actions = Actions;
+
+export declare namespace TtsIntegrations {
+  export { Actions as Actions };
+}

package/src/resources/tts-integrations.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './tts-integrations/index';

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

@@ -141,6 +141,17 @@ export interface UacConnection {
    */
   authentication?: 'uac-authentication';
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Defaults to false and returns the saved value. Only JSON true and false
+   * are accepted; null and non-boolean values are rejected. This preference is
+   * independent of default_on_hold_comfort_noise_enabled and does not modify that
+   * setting. This API provisions the preference; call-processing behavior is
+   * implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -173,8 +184,8 @@ export interface UacConnection {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 
@@ -769,6 +780,17 @@ export interface UacConnectionCreateParams {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Optional; defaults to false when omitted on creation. Only JSON true and
+   * false are accepted; null and non-boolean values are rejected. This preference is
+   * independent of default_on_hold_comfort_noise_enabled and does not modify that
+   * setting. This API provisions the preference; call-processing behavior is
+   * implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -794,8 +816,8 @@ export interface UacConnectionCreateParams {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 
@@ -927,6 +949,17 @@ export interface UacConnectionUpdateParams {
    */
   android_push_credential_id?: string | null;
 
+  /**
+   * Stores the connection preference for generating silent RTP toward the opposite
+   * call leg when comfort-noise packets (CN, payload type 13) are received during
+   * hold. Optional; omitting this field preserves the saved value. Only JSON true
+   * and false are accepted; null and non-boolean values are rejected. This
+   * preference is independent of default_on_hold_comfort_noise_enabled and does not
+   * modify that setting. This API provisions the preference; call-processing
+   * behavior is implemented separately.
+   */
+  bridge_generate_comfort_noise_on_cn?: boolean;
+
   /**
    * Specifies if call cost webhooks should be sent for this connection.
    */
@@ -957,8 +990,8 @@ export interface UacConnectionUpdateParams {
   encode_contact_header_enabled?: boolean;
 
   /**
-   * Enable use of SRTP for encryption. Cannot be set if the transport_portocol is
-   * TLS.
+   * Enable use of SRTP for encryption. Can only be set when the SIP signaling
+   * transport protocol is TLS.
    */
   encrypted_media?: CredentialConnectionsAPI.EncryptedMedia | null;
 

package/src/resources/voice-clones.ts

@@ -58,10 +58,12 @@ 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–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.
+   * formats: WAV, MP3, FLAC, OGG, M4A. Maximum file size: 20MB. Reference audio is
+   * trimmed per model: Qwen3TTS and Bayan use the first 10 seconds, Ultra uses up to
+   * 60 seconds, and Minimax accepts 10 seconds to 5 minutes. Ultra clones return
+   * `202` with status `pending`; all other models return `201` with status `active`.
+   * Bayan clones require `ref_text` (the exact transcript of the reference audio)
+   * and support `ar` (default) and `en` only.
    *
    * @example
    * ```ts
@@ -177,7 +179,7 @@ export interface VoiceCloneData {
   /**
    * TTS model identifier for the voice clone.
    */
-  model_id?: 'Qwen3TTS' | 'Ultra' | 'speech-2.8-turbo';
+  model_id?: 'Qwen3TTS' | 'Ultra' | 'Bayan' | 'speech-2.8-turbo';
 
   /**
    * Name of the voice clone.
@@ -352,11 +354,12 @@ export namespace VoiceCloneCreateParams {
 export interface VoiceCloneCreateFromUploadParams {
   /**
    * Multipart form data for creating a voice clone from a direct audio upload.
-   * Maximum file size: 5MB for Telnyx, 20MB for Minimax.
+   * Maximum file size: 20MB.
    */
   voice_clone_upload_request:
     | VoiceCloneCreateFromUploadParams.TelnyxQwen3TtsClone
     | VoiceCloneCreateFromUploadParams.TelnyxUltraClone
+    | VoiceCloneCreateFromUploadParams.TelnyxBayanClone
     | VoiceCloneCreateFromUploadParams.MinimaxClone;
 }
 
@@ -368,7 +371,7 @@ export namespace 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.
+     * size: 20MB.
      */
     audio_file: Uploadable;
 
@@ -415,7 +418,7 @@ export namespace VoiceCloneCreateFromUploadParams {
     /**
      * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
      * For best quality, provide up to 60 seconds of clear, uninterrupted speech.
-     * Maximum size: 5MB.
+     * Maximum size: 20MB.
      */
     audio_file: Uploadable;
 
@@ -425,7 +428,7 @@ export namespace VoiceCloneCreateFromUploadParams {
     gender: 'male' | 'female' | 'neutral';
 
     /**
-     * ISO 639-1 language code from the Ultra language set (40 languages).
+     * ISO 639-1 language code from the Ultra language set (42 languages).
      */
     language: string;
 
@@ -455,6 +458,59 @@ export namespace VoiceCloneCreateFromUploadParams {
     ref_text?: string;
   }
 
+  /**
+   * Upload-based voice clone using the Telnyx Bayan model (Arabic and English). The
+   * clone is `active` on creation. Use it as voice `Telnyx.Bayan.<clone_id>`.
+   */
+  export interface TelnyxBayanClone {
+    /**
+     * Audio file to clone the voice from. Supported formats: WAV, MP3, FLAC, OGG, M4A.
+     * Converted to 24 kHz mono WAV and trimmed to the first 10 seconds. For best
+     * quality, provide about 10 seconds of clean, single-speaker speech. Maximum size:
+     * 20MB.
+     */
+    audio_file: Uploadable;
+
+    /**
+     * Gender of the voice clone.
+     */
+    gender: 'male' | 'female' | 'neutral';
+
+    /**
+     * TTS model identifier. Must be `Bayan`.
+     */
+    model_id: 'Bayan';
+
+    /**
+     * Name for the voice clone.
+     */
+    name: string;
+
+    /**
+     * Exact transcript of the reference audio. Required for Bayan: a missing, empty,
+     * or whitespace-only value returns `422` with `source.pointer` `/ref_text`. An
+     * inaccurate transcript can make synthesis with the clone truncated or garbled.
+     * Record a known script of about 10 seconds and pass it verbatim.
+     */
+    ref_text: string;
+
+    /**
+     * Optional custom label describing the voice style.
+     */
+    label?: string;
+
+    /**
+     * Language of the reference audio: `ar` (Arabic) or `en` (English). Defaults to
+     * `ar`. Other values return `422`.
+     */
+    language?: 'ar' | 'en';
+
+    /**
+     * Voice synthesis provider. Defaults to `telnyx`.
+     */
+    provider?: 'telnyx' | 'Telnyx';
+  }
+
   /**
    * Upload-based voice clone using the Minimax provider.
    */