telnyx 7.9.0 → 7.11.0

package/src/resources/legacy/reporting/usage-reports/usage-reports.ts

@@ -18,11 +18,12 @@ import {
   NumberLookup,
   NumberLookupCreateParams,
   NumberLookupCreateResponse,
-  NumberLookupListResponse,
+  NumberLookupListParams,
   NumberLookupRetrieveResponse,
   TelcoDataAggregation,
   TelcoDataUsageRecord,
   TelcoDataUsageReportResponse,
+  TelcoDataUsageReportResponsesPerPagePagination,
 } from './number-lookup';
 import * as VoiceAPI from './voice';
 import {
@@ -109,7 +110,8 @@ export declare namespace UsageReports {
     type TelcoDataUsageReportResponse as TelcoDataUsageReportResponse,
     type NumberLookupCreateResponse as NumberLookupCreateResponse,
     type NumberLookupRetrieveResponse as NumberLookupRetrieveResponse,
-    type NumberLookupListResponse as NumberLookupListResponse,
+    type TelcoDataUsageReportResponsesPerPagePagination as TelcoDataUsageReportResponsesPerPagePagination,
+    type NumberLookupListParams as NumberLookupListParams,
     type NumberLookupCreateParams as NumberLookupCreateParams,
   };
 

package/src/resources/messaging-10dlc/phone-number-campaigns.ts

@@ -139,6 +139,11 @@ export interface PhoneNumberCampaign {
    */
   failureReasons?: string;
 
+  /**
+   * The assignment status of the number towards other carriers.
+   */
+  nonTmobileNumberMappingStatus?: string;
+
   /**
    * TCR's alphanumeric ID for the brand.
    */
@@ -153,6 +158,11 @@ export interface PhoneNumberCampaign {
    * Campaign ID. Empty if the number is associated to a shared campaign.
    */
   telnyxCampaignId?: string;
+
+  /**
+   * The T-Mobile assignment status of the number.
+   */
+  tmobileNumberMappingStatus?: string;
 }
 
 export interface PhoneNumberCampaignCreate {

package/src/resources/phone-numbers/actions.ts

@@ -238,7 +238,7 @@ export interface ActionChangeBundleStatusParams {
    * bundle to another directly. You must first remove it from a bundle, and then
    * assign it to a new bundle.
    */
-  bundle_id: string;
+  bundle_id: string | null;
 }
 
 export interface ActionEnableEmergencyParams {

package/src/resources/shared.ts

@@ -1173,6 +1173,9 @@ export interface ShortCode {
    */
   short_code?: string;
 
+  /**
+   * Tags associated with the resource.
+   */
   tags?: Array<string>;
 
   /**

package/src/resources/short-codes.ts

@@ -109,6 +109,9 @@ export interface ShortCodeUpdateParams {
    */
   messaging_profile_id: string;
 
+  /**
+   * Tags associated with the resource.
+   */
   tags?: Array<string>;
 }
 

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

@@ -43,7 +43,7 @@ export class SpeechToText extends APIResource {
    * `Authorization: Bearer <API_KEY>` header.
    *
    * Supported engines: `Azure`, `Deepgram`, `Google`, `Telnyx`, `xAI`,
-   * `Speechmatics`, `Soniox`, `Parakeet`.
+   * `Speechmatics`, `Soniox`, `Parakeet`, `Humain`.
    *
    * **Connection flow:**
    *
@@ -214,6 +214,7 @@ export interface SpeechToTextListProvidersParams {
     | 'xai'
     | 'soniox'
     | 'parakeet'
+    | 'humain'
     | 'azure'
     | 'openai'
     | 'google'
@@ -247,7 +248,8 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'xAI'
     | 'Speechmatics'
     | 'Soniox'
-    | 'Parakeet';
+    | 'Parakeet'
+    | 'Humain';
 
   /**
    * Silence duration (in milliseconds) that triggers end-of-speech detection. When
@@ -300,7 +302,8 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'xai/grok-stt'
     | 'speechmatics/standard'
     | 'soniox/stt-rt-v4'
-    | 'nvidia/parakeet-v3';
+    | 'nvidia/parakeet-v3'
+    | 'humain/realtime';
 
   /**
    * Enable redaction of sensitive information (e.g., PCI data, SSN) from

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

@@ -37,7 +37,7 @@ export class TextToSpeech extends APIResource {
    * with provider-specific parameters.
    *
    * Supported providers: `aws`, `telnyx`, `azure`, `elevenlabs`, `minimax`, `rime`,
-   * `resemble`, `xai`.
+   * `resemble`, `xai`, `humain`.
    *
    * The Telnyx `Ultra` model supports 44 languages with emotion control, speed
    * adjustment, and volume control. Use the `telnyx` provider-specific parameters to
@@ -57,7 +57,7 @@ export class TextToSpeech extends APIResource {
    * synthesize; receive JSON frames containing base64-encoded audio chunks.
    *
    * Supported providers: `aws`, `telnyx`, `azure`, `murfai`, `minimax`, `rime`,
-   * `resemble`, `elevenlabs`, `xai`.
+   * `resemble`, `elevenlabs`, `xai`, `humain`.
    *
    * **Connection flow:**
    *
@@ -264,7 +264,7 @@ export interface TextToSpeechListVoicesParams {
   /**
    * Filter voices by provider. If omitted, voices from all providers are returned.
    */
-  provider?: 'aws' | 'telnyx' | 'azure' | 'elevenlabs' | 'minimax' | 'rime' | 'resemble' | 'xai';
+  provider?: 'aws' | 'telnyx' | 'azure' | 'elevenlabs' | 'minimax' | 'rime' | 'resemble' | 'xai' | 'humain';
 }
 
 export interface TextToSpeechGenerateSpeechParams {
@@ -288,6 +288,13 @@ export interface TextToSpeechGenerateSpeechParams {
    */
   elevenlabs?: TextToSpeechGenerateSpeechParams.Elevenlabs;
 
+  /**
+   * Humain provider-specific parameters. Unlike other providers, Humain has no
+   * format/sample-rate negotiation (output is always PCM16 24kHz mono) and no
+   * language parameter — language is fixed per voice.
+   */
+  humain?: TextToSpeechGenerateSpeechParams.Humain;
+
   /**
    * Language code (e.g. `en-US`). Usage varies by provider.
    */
@@ -307,7 +314,7 @@ export interface TextToSpeechGenerateSpeechParams {
   /**
    * TTS provider. Required unless `voice` is provided.
    */
-  provider?: 'aws' | 'telnyx' | 'azure' | 'elevenlabs' | 'minimax' | 'rime' | 'resemble' | 'xai';
+  provider?: 'aws' | 'telnyx' | 'azure' | 'elevenlabs' | 'minimax' | 'rime' | 'resemble' | 'xai' | 'humain';
 
   /**
    * Resemble AI provider-specific parameters.
@@ -456,6 +463,23 @@ export namespace TextToSpeechGenerateSpeechParams {
     voice_settings?: { [key: string]: unknown };
   }
 
+  /**
+   * Humain provider-specific parameters. Unlike other providers, Humain has no
+   * format/sample-rate negotiation (output is always PCM16 24kHz mono) and no
+   * language parameter — language is fixed per voice.
+   */
+  export interface Humain {
+    /**
+     * Humain voice identifier.
+     */
+    voice_id: 'sara-en' | 'abdulaziz-en' | 'sara-ar' | 'abdulaziz-ar' | 'nourah-ar' | 'abdullah-ar';
+
+    /**
+     * Time-to-first-byte eagerness, trading synthesis latency for quality.
+     */
+    ttfb_eagerness?: number;
+  }
+
   /**
    * Minimax provider-specific parameters.
    */
@@ -621,7 +645,17 @@ export interface TextToSpeechRetrieveSpeechParams {
    * TTS provider. Defaults to `telnyx` if not specified. Ignored when `voice` is
    * provided.
    */
-  provider?: 'aws' | 'telnyx' | 'azure' | 'elevenlabs' | 'minimax' | 'murfai' | 'rime' | 'resemble' | 'xai';
+  provider?:
+    | 'aws'
+    | 'telnyx'
+    | 'azure'
+    | 'elevenlabs'
+    | 'minimax'
+    | 'murfai'
+    | 'rime'
+    | 'resemble'
+    | 'xai'
+    | 'humain';
 
   /**
    * Client-provided socket identifier for tracking. If not provided, one is

package/src/resources/webhooks.ts

@@ -361,7 +361,7 @@ export namespace CallAnswered {
     /**
      * User-to-User and Diversion headers from sip invite.
      */
-    sip_headers?: Array<CallsAPI.SipHeader>;
+    sip_headers?: Array<Payload.SipHeader>;
 
     /**
      * ISO 8601 datetime of when the call started.
@@ -383,6 +383,20 @@ export namespace CallAnswered {
      */
     to?: string;
   }
+
+  export namespace Payload {
+    export interface SipHeader {
+      /**
+       * The name of the header received from the SIP INVITE.
+       */
+      name: 'User-to-User' | 'Diversion';
+
+      /**
+       * The value of the header.
+       */
+      value: string;
+    }
+  }
 }
 
 export interface CallBridged {
@@ -1088,7 +1102,7 @@ export namespace CallHangup {
     /**
      * User-to-User and Diversion headers from sip invite.
      */
-    sip_headers?: Array<CallsAPI.SipHeader>;
+    sip_headers?: Array<Payload.SipHeader>;
 
     /**
      * ISO 8601 datetime of when the call started.
@@ -1175,6 +1189,18 @@ export namespace CallHangup {
         skip_packet_count?: string;
       }
     }
+
+    export interface SipHeader {
+      /**
+       * The name of the header received from the SIP INVITE.
+       */
+      name: 'User-to-User' | 'Diversion';
+
+      /**
+       * The value of the header.
+       */
+      value: string;
+    }
   }
 }
 
@@ -1279,7 +1305,7 @@ export namespace CallInitiated {
     /**
      * User-to-User and Diversion headers from sip invite.
      */
-    sip_headers?: Array<CallsAPI.SipHeader>;
+    sip_headers?: Array<Payload.SipHeader>;
 
     /**
      * ISO 8601 datetime of when the call started.
@@ -1301,6 +1327,20 @@ export namespace CallInitiated {
      */
     to?: string;
   }
+
+  export namespace Payload {
+    export interface SipHeader {
+      /**
+       * The name of the header received from the SIP INVITE.
+       */
+      name: 'User-to-User' | 'Diversion';
+
+      /**
+       * The value of the header.
+       */
+      value: string;
+    }
+  }
 }
 
 export interface CallLeftQueue {
@@ -3912,9 +3952,10 @@ export namespace FaxFailed {
       direction?: 'inbound' | 'outbound';
 
       /**
-       * Cause of the sending failure
+       * Customer-facing cause of the fax failure. Mapped from the more granular
+       * `internal_failure_reason`.
        */
-      failure_reason?: 'rejected';
+      failure_reason?: string;
 
       /**
        * Identifies the fax.
@@ -3926,6 +3967,12 @@ export namespace FaxFailed {
        */
       from?: string;
 
+      /**
+       * Internal, more granular cause of the fax failure. Useful for deeper debugging
+       * beyond the customer-facing `failure_reason`.
+       */
+      internal_failure_reason?: string;
+
       /**
        * The media_name used for the fax's media. Must point to a file previously
        * uploaded to api.telnyx.com/v2/media by the same user/organization. Supported

package/src/resources/whatsapp/phone-numbers/conversational-components.ts

@@ -0,0 +1,145 @@
+// 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';
+
+/**
+ * Manage Whatsapp phone numbers
+ */
+export class ConversationalComponents extends APIResource {
+  /**
+   * Get phone number conversational components
+   *
+   * @example
+   * ```ts
+   * const conversationalComponents =
+   *   await client.whatsapp.phoneNumbers.conversationalComponents.list(
+   *     'phone_number',
+   *   );
+   * ```
+   */
+  list(phoneNumber: string, options?: RequestOptions): APIPromise<ConversationalComponentListResponse> {
+    return this._client.get(
+      path`/v2/whatsapp/phone_numbers/${phoneNumber}/conversational_components`,
+      options,
+    );
+  }
+
+  /**
+   * Update phone number conversational components
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.whatsapp.phoneNumbers.conversationalComponents.patchAll(
+   *     'phone_number',
+   *   );
+   * ```
+   */
+  patchAll(
+    phoneNumber: string,
+    body: ConversationalComponentPatchAllParams,
+    options?: RequestOptions,
+  ): APIPromise<ConversationalComponentPatchAllResponse> {
+    return this._client.patch(path`/v2/whatsapp/phone_numbers/${phoneNumber}/conversational_components`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface ConversationalComponentListResponse {
+  data?: ConversationalComponentListResponse.Data;
+}
+
+export namespace ConversationalComponentListResponse {
+  export interface Data {
+    /**
+     * List of commands
+     */
+    commands?: Array<Data.Command>;
+
+    /**
+     * List of ice breakers
+     */
+    ice_breakers?: Array<string>;
+
+    /**
+     * Phone number in E164 format
+     */
+    phone_number?: string;
+
+    record_type?: string;
+  }
+
+  export namespace Data {
+    export interface Command {
+      command?: string;
+
+      description?: string;
+    }
+  }
+}
+
+export interface ConversationalComponentPatchAllResponse {
+  data?: ConversationalComponentPatchAllResponse.Data;
+}
+
+export namespace ConversationalComponentPatchAllResponse {
+  export interface Data {
+    /**
+     * List of commands
+     */
+    commands?: Array<Data.Command>;
+
+    /**
+     * List of ice breakers
+     */
+    ice_breakers?: Array<string>;
+
+    /**
+     * Phone number in E164 format
+     */
+    phone_number?: string;
+
+    record_type?: string;
+  }
+
+  export namespace Data {
+    export interface Command {
+      command?: string;
+
+      description?: string;
+    }
+  }
+}
+
+export interface ConversationalComponentPatchAllParams {
+  /**
+   * List of commands
+   */
+  commands?: Array<ConversationalComponentPatchAllParams.Command>;
+
+  /**
+   * List of ice breakers
+   */
+  ice_breakers?: Array<string>;
+}
+
+export namespace ConversationalComponentPatchAllParams {
+  export interface Command {
+    command?: string;
+
+    description?: string;
+  }
+}
+
+export declare namespace ConversationalComponents {
+  export {
+    type ConversationalComponentListResponse as ConversationalComponentListResponse,
+    type ConversationalComponentPatchAllResponse as ConversationalComponentPatchAllResponse,
+    type ConversationalComponentPatchAllParams as ConversationalComponentPatchAllParams,
+  };
+}

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

@@ -7,6 +7,12 @@ export {
   type CallingSettingUpdateResponse,
   type CallingSettingUpdateParams,
 } from './calling-settings';
+export {
+  ConversationalComponents,
+  type ConversationalComponentListResponse,
+  type ConversationalComponentPatchAllResponse,
+  type ConversationalComponentPatchAllParams,
+} from './conversational-components';
 export {
   PhoneNumbers,
   type PhoneNumberListResponse,

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

@@ -9,6 +9,13 @@ import {
   CallingSettings,
   WhatsappCallingSettingsData,
 } from './calling-settings';
+import * as ConversationalComponentsAPI from './conversational-components';
+import {
+  ConversationalComponentListResponse,
+  ConversationalComponentPatchAllParams,
+  ConversationalComponentPatchAllResponse,
+  ConversationalComponents,
+} from './conversational-components';
 import * as ProfileAPI from './profile/profile';
 import {
   Profile,
@@ -33,6 +40,8 @@ import { path } from '../../../internal/utils/path';
 export class PhoneNumbers extends APIResource {
   callingSettings: CallingSettingsAPI.CallingSettings = new CallingSettingsAPI.CallingSettings(this._client);
   profile: ProfileAPI.Profile = new ProfileAPI.Profile(this._client);
+  conversationalComponents: ConversationalComponentsAPI.ConversationalComponents =
+    new ConversationalComponentsAPI.ConversationalComponents(this._client);
 
   /**
    * List Whatsapp phone numbers
@@ -197,7 +206,7 @@ export namespace PhoneNumberRetrieveConversationWindowResponse {
     /**
      * When the window closes. Null if no active window.
      */
-    window_expires_at?: string;
+    window_expires_at?: string | null;
 
     /**
      * Window type. Currently always 24h when present.
@@ -225,6 +234,7 @@ export interface PhoneNumberRetrieveConversationWindowParams {
 
 PhoneNumbers.CallingSettings = CallingSettings;
 PhoneNumbers.Profile = Profile;
+PhoneNumbers.ConversationalComponents = ConversationalComponents;
 
 export declare namespace PhoneNumbers {
   export {
@@ -252,4 +262,11 @@ export declare namespace PhoneNumbers {
     type ProfileUpdateResponse as ProfileUpdateResponse,
     type ProfileUpdateParams as ProfileUpdateParams,
   };
+
+  export {
+    ConversationalComponents as ConversationalComponents,
+    type ConversationalComponentListResponse as ConversationalComponentListResponse,
+    type ConversationalComponentPatchAllResponse as ConversationalComponentPatchAllResponse,
+    type ConversationalComponentPatchAllParams as ConversationalComponentPatchAllParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.9.0'; // x-release-please-version
+export const VERSION = '7.11.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}