telnyx 6.35.0 → 6.36.0

package/src/resources/enterprises/reputation/reputation.ts

@@ -3,9 +3,9 @@
 import { APIResource } from '../../../core/resource';
 import * as NumbersAPI from './numbers';
 import {
-  NumberCreateParams,
-  NumberCreateResponse,
-  NumberDeleteParams,
+  NumberAssociateParams,
+  NumberAssociateResponse,
+  NumberDisassociateParams,
   NumberListParams,
   NumberRetrieveParams,
   NumberRetrieveResponse,
@@ -22,50 +22,6 @@ import { path } from '../../../internal/utils/path';
 export class Reputation extends APIResource {
   numbers: NumbersAPI.Numbers = new NumbersAPI.Numbers(this._client);
 
-  /**
-   * Enable Number Reputation service for an enterprise.
-   *
-   * **Requirements:**
-   *
-   * - Signed LOA (Letter of Authorization) document ID
-   * - Reputation check frequency (defaults to `business_daily`)
-   * - Number Reputation Terms of Service must be accepted
-   *
-   * **Flow:**
-   *
-   * 1. Registers the enterprise for reputation monitoring
-   * 2. Creates reputation settings with `pending` status
-   * 3. Awaits admin approval before monitoring begins
-   *
-   * **Resubmission After Rejection:** If a previously rejected record exists, this
-   * endpoint will delete it and create a new `pending` record.
-   *
-   * **Available Frequencies:**
-   *
-   * - `business_daily` — Monday–Friday
-   * - `daily` — Every day
-   * - `weekly` — Once per week
-   * - `biweekly` — Once every two weeks
-   * - `monthly` — Once per month
-   * - `never` — Manual refresh only
-   *
-   * @example
-   * ```ts
-   * const reputation =
-   *   await client.enterprises.reputation.create(
-   *     '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
-   *     { loa_document_id: 'doc_01HXYZ1234ABCDEF' },
-   *   );
-   * ```
-   */
-  create(
-    enterpriseID: string,
-    body: ReputationCreateParams,
-    options?: RequestOptions,
-  ): APIPromise<ReputationCreateResponse> {
-    return this._client.post(path`/enterprises/${enterpriseID}/reputation`, { body, ...options });
-  }
-
   /**
    * Retrieve the current Number Reputation settings for an enterprise.
    *
@@ -76,13 +32,13 @@ export class Reputation extends APIResource {
    *
    * @example
    * ```ts
-   * const reputations =
-   *   await client.enterprises.reputation.list(
+   * const reputation =
+   *   await client.enterprises.reputation.retrieve(
    *     '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
    *   );
    * ```
    */
-  list(enterpriseID: string, options?: RequestOptions): APIPromise<ReputationListResponse> {
+  retrieve(enterpriseID: string, options?: RequestOptions): APIPromise<ReputationRetrieveResponse> {
     return this._client.get(path`/enterprises/${enterpriseID}/reputation`, options);
   }
 
@@ -99,18 +55,61 @@ export class Reputation extends APIResource {
    *
    * @example
    * ```ts
-   * await client.enterprises.reputation.deleteAll(
+   * await client.enterprises.reputation.disable(
    *   '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
    * );
    * ```
    */
-  deleteAll(enterpriseID: string, options?: RequestOptions): APIPromise<void> {
+  disable(enterpriseID: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/enterprises/${enterpriseID}/reputation`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
+  /**
+   * Enable Number Reputation service for an enterprise.
+   *
+   * **Requirements:**
+   *
+   * - Signed LOA (Letter of Authorization) document ID
+   * - Reputation check frequency (defaults to `business_daily`)
+   * - Number Reputation Terms of Service must be accepted
+   *
+   * **Flow:**
+   *
+   * 1. Registers the enterprise for reputation monitoring
+   * 2. Creates reputation settings with `pending` status
+   * 3. Awaits admin approval before monitoring begins
+   *
+   * **Resubmission After Rejection:** If a previously rejected record exists, this
+   * endpoint will delete it and create a new `pending` record.
+   *
+   * **Available Frequencies:**
+   *
+   * - `business_daily` — Monday–Friday
+   * - `daily` — Every day
+   * - `weekly` — Once per week
+   * - `biweekly` — Once every two weeks
+   * - `monthly` — Once per month
+   * - `never` — Manual refresh only
+   *
+   * @example
+   * ```ts
+   * const response = await client.enterprises.reputation.enable(
+   *   '6a09cdc3-8948-47f0-aa62-74ac943d6c58',
+   *   { loa_document_id: 'doc_01HXYZ1234ABCDEF' },
+   * );
+   * ```
+   */
+  enable(
+    enterpriseID: string,
+    body: ReputationEnableParams,
+    options?: RequestOptions,
+  ): APIPromise<ReputationEnableResponse> {
+    return this._client.post(path`/enterprises/${enterpriseID}/reputation`, { body, ...options });
+  }
+
   /**
    * Update how often reputation data is automatically refreshed.
    *
@@ -181,11 +180,11 @@ export interface EnterpriseReputationPublic {
   updated_at?: string;
 }
 
-export interface ReputationCreateResponse {
+export interface ReputationRetrieveResponse {
   data?: EnterpriseReputationPublic;
 }
 
-export interface ReputationListResponse {
+export interface ReputationEnableResponse {
   data?: EnterpriseReputationPublic;
 }
 
@@ -193,7 +192,7 @@ export interface ReputationUpdateFrequencyResponse {
   data?: EnterpriseReputationPublic;
 }
 
-export interface ReputationCreateParams {
+export interface ReputationEnableParams {
   /**
    * ID of the signed Letter of Authorization (LOA) document uploaded to the document
    * service
@@ -218,20 +217,20 @@ Reputation.Numbers = Numbers;
 export declare namespace Reputation {
   export {
     type EnterpriseReputationPublic as EnterpriseReputationPublic,
-    type ReputationCreateResponse as ReputationCreateResponse,
-    type ReputationListResponse as ReputationListResponse,
+    type ReputationRetrieveResponse as ReputationRetrieveResponse,
+    type ReputationEnableResponse as ReputationEnableResponse,
     type ReputationUpdateFrequencyResponse as ReputationUpdateFrequencyResponse,
-    type ReputationCreateParams as ReputationCreateParams,
+    type ReputationEnableParams as ReputationEnableParams,
     type ReputationUpdateFrequencyParams as ReputationUpdateFrequencyParams,
   };
 
   export {
     Numbers as Numbers,
-    type NumberCreateResponse as NumberCreateResponse,
     type NumberRetrieveResponse as NumberRetrieveResponse,
-    type NumberCreateParams as NumberCreateParams,
+    type NumberAssociateResponse as NumberAssociateResponse,
     type NumberRetrieveParams as NumberRetrieveParams,
     type NumberListParams as NumberListParams,
-    type NumberDeleteParams as NumberDeleteParams,
+    type NumberAssociateParams as NumberAssociateParams,
+    type NumberDisassociateParams as NumberDisassociateParams,
   };
 }

package/src/resources/index.ts

@@ -1195,7 +1195,13 @@ export {
   type TelephonyCredentialsDefaultFlatPagination,
 } from './telephony-credentials';
 export { TermsOfService } from './terms-of-service/terms-of-service';
-export { Texml, type TexmlSecretsResponse, type TexmlSecretsParams } from './texml/texml';
+export {
+  Texml,
+  type TexmlInitiateAICallResponse,
+  type TexmlSecretsResponse,
+  type TexmlInitiateAICallParams,
+  type TexmlSecretsParams,
+} from './texml/texml';
 export {
   TexmlApplications,
   type TexmlApplication,

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

@@ -787,6 +787,14 @@ export interface CallCallsParams {
    */
   MachineDetectionTimeout?: number;
 
+  /**
+   * Defines whether media should be encrypted on the call. When set to `SRTP`, the
+   * call will use Secure Real-time Transport Protocol for media encryption. When set
+   * to `DTLS`, the call will use DTLS for media encryption. Only supported for SIP
+   * destinations.
+   */
+  MediaEncryption?: 'disabled' | 'SRTP' | 'DTLS';
+
   /**
    * The list of comma-separated codecs to be offered on a call.
    */

package/src/resources/texml/index.ts

@@ -9,4 +9,10 @@ export {
   type AccountRetrieveRecordingsJsonParams,
   type AccountRetrieveTranscriptionsJsonParams,
 } from './accounts/index';
-export { Texml, type TexmlSecretsResponse, type TexmlSecretsParams } from './texml';
+export {
+  Texml,
+  type TexmlInitiateAICallResponse,
+  type TexmlSecretsResponse,
+  type TexmlInitiateAICallParams,
+  type TexmlSecretsParams,
+} from './texml';

package/src/resources/texml/texml.ts

@@ -13,6 +13,7 @@ import {
 } from './accounts/accounts';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
 
 /**
  * TeXML REST Commands
@@ -20,6 +21,36 @@ import { RequestOptions } from '../../internal/request-options';
 export class Texml extends APIResource {
   accounts: AccountsAPI.Accounts = new AccountsAPI.Accounts(this._client);
 
+  /**
+   * Initiate an outbound AI call with warm-up support. Validates parameters, builds
+   * an internal TeXML with an AI Assistant configuration, encodes instructions into
+   * client state, and calls the dial API. The Twiml, Texml, and Url parameters are
+   * not allowed and will result in a 422 error.
+   *
+   * @example
+   * ```ts
+   * const response = await client.texml.initiateAICall(
+   *   'connection_id',
+   *   {
+   *     AIAssistantId: 'ai-assistant-id-123',
+   *     From: '+13120001234',
+   *     To: '+13121230000',
+   *   },
+   * );
+   * ```
+   */
+  initiateAICall(
+    connectionID: string,
+    params: TexmlInitiateAICallParams,
+    options?: RequestOptions,
+  ): APIPromise<TexmlInitiateAICallResponse> {
+    const { timeout_seconds, ...body } = params;
+    return this._client.post(path`/texml/ai_calls/${connectionID}`, {
+      body: { Timeout: timeout_seconds, ...body },
+      ...options,
+    });
+  }
+
   /**
    * Create a TeXML secret which can be later used as a Dynamic Parameter for TeXML
    * when using Mustache Templates in your TeXML. In your TeXML you will be able to
@@ -40,6 +71,16 @@ export class Texml extends APIResource {
   }
 }
 
+export interface TexmlInitiateAICallResponse {
+  call_sid?: string;
+
+  from?: string;
+
+  status?: string;
+
+  to?: string;
+}
+
 export interface TexmlSecretsResponse {
   data?: TexmlSecretsResponse.Data;
 }
@@ -52,6 +93,238 @@ export namespace TexmlSecretsResponse {
   }
 }
 
+export interface TexmlInitiateAICallParams {
+  /**
+   * The ID of the AI assistant to use for the call.
+   */
+  AIAssistantId: string;
+
+  /**
+   * The phone number of the party initiating the call. Phone numbers are formatted
+   * with a `+` and country code.
+   */
+  From: string;
+
+  /**
+   * The phone number of the called party. Phone numbers are formatted with a `+` and
+   * country code.
+   */
+  To: string;
+
+  /**
+   * Key-value map of dynamic variables to pass to the AI assistant.
+   */
+  AIAssistantDynamicVariables?: { [key: string]: string };
+
+  /**
+   * The version of the AI assistant to use.
+   */
+  AIAssistantVersion?: string;
+
+  /**
+   * Select whether to perform answering machine detection in the background. By
+   * default execution is blocked until Answering Machine Detection is completed.
+   */
+  AsyncAmd?: boolean;
+
+  /**
+   * URL destination for Telnyx to send AMD callback events to for the call.
+   */
+  AsyncAmdStatusCallback?: string;
+
+  /**
+   * HTTP request type used for `AsyncAmdStatusCallback`.
+   */
+  AsyncAmdStatusCallbackMethod?: 'GET' | 'POST';
+
+  /**
+   * To be used as the caller id name (SIP From Display Name) presented to the
+   * destination (`To` number). The string should have a maximum of 128 characters,
+   * containing only letters, numbers, spaces, and `-_~!.+` special characters. If
+   * omitted, the display name will be the same as the number in the `From` field.
+   */
+  CallerId?: string;
+
+  /**
+   * URL destination for Telnyx to send conversation callback events to.
+   */
+  ConversationCallback?: string;
+
+  /**
+   * HTTP request type used for `ConversationCallback`.
+   */
+  ConversationCallbackMethod?: 'GET' | 'POST';
+
+  /**
+   * An array of URL destinations for conversation callback events.
+   */
+  ConversationCallbacks?: Array<string>;
+
+  /**
+   * Custom HTTP headers to be sent with the call. Each header should be an object
+   * with 'name' and 'value' properties.
+   */
+  CustomHeaders?: Array<TexmlInitiateAICallParams.CustomHeader>;
+
+  /**
+   * Allows you to choose between Premium and Standard detections.
+   */
+  DetectionMode?: 'Premium' | 'Regular';
+
+  /**
+   * Enables Answering Machine Detection.
+   */
+  MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
+
+  /**
+   * If initial silence duration is greater than this value, consider it a machine.
+   * Ignored when `premium` detection is used.
+   */
+  MachineDetectionSilenceTimeout?: number;
+
+  /**
+   * Silence duration threshold after a greeting message or voice for it be
+   * considered human. Ignored when `premium` detection is used.
+   */
+  MachineDetectionSpeechEndThreshold?: number;
+
+  /**
+   * Maximum threshold of a human greeting. If greeting longer than this value,
+   * considered machine. Ignored when `premium` detection is used.
+   */
+  MachineDetectionSpeechThreshold?: number;
+
+  /**
+   * Maximum timeout threshold in milliseconds for overall detection.
+   */
+  MachineDetectionTimeout?: number;
+
+  /**
+   * A string of passport identifiers to associate with the call.
+   */
+  Passports?: string;
+
+  /**
+   * The list of comma-separated codecs to be offered on a call.
+   */
+  PreferredCodecs?: string;
+
+  /**
+   * Whether to record the entire participant's call leg. Defaults to `false`.
+   */
+  Record?: boolean;
+
+  /**
+   * The number of channels in the final recording. Defaults to `mono`.
+   */
+  RecordingChannels?: 'mono' | 'dual';
+
+  /**
+   * The URL the recording callbacks will be sent to.
+   */
+  RecordingStatusCallback?: string;
+
+  /**
+   * The changes to the recording's state that should generate a call to
+   * `RecordingStatusCallback`. Can be: `in-progress`, `completed` and `absent`.
+   * Separate multiple values with a space. Defaults to `completed`.
+   */
+  RecordingStatusCallbackEvent?: string;
+
+  /**
+   * HTTP request type used for `RecordingStatusCallback`. Defaults to `POST`.
+   */
+  RecordingStatusCallbackMethod?: 'GET' | 'POST';
+
+  /**
+   * The number of seconds that Telnyx will wait for the recording to be stopped if
+   * silence is detected. The timer only starts when the speech is detected. The
+   * minimum value is 0. The default value is 0 (infinite).
+   */
+  RecordingTimeout?: number;
+
+  /**
+   * The audio track to record for the call. The default is `both`.
+   */
+  RecordingTrack?: 'inbound' | 'outbound' | 'both';
+
+  /**
+   * Whether to send RecordingUrl in webhooks.
+   */
+  SendRecordingUrl?: boolean;
+
+  /**
+   * The password to use for SIP authentication.
+   */
+  SipAuthPassword?: string;
+
+  /**
+   * The username to use for SIP authentication.
+   */
+  SipAuthUsername?: string;
+
+  /**
+   * Defines the SIP region to be used for the call.
+   */
+  SipRegion?: 'US' | 'Europe' | 'Canada' | 'Australia' | 'Middle East';
+
+  /**
+   * URL destination for Telnyx to send status callback events to for the call.
+   */
+  StatusCallback?: string;
+
+  /**
+   * The call events for which Telnyx should send a webhook. Multiple events can be
+   * defined when separated by a space. Valid values: initiated, ringing, answered,
+   * completed.
+   */
+  StatusCallbackEvent?: string;
+
+  /**
+   * HTTP request type used for `StatusCallback`.
+   */
+  StatusCallbackMethod?: 'GET' | 'POST';
+
+  /**
+   * An array of URL destinations for Telnyx to send status callback events to for
+   * the call.
+   */
+  StatusCallbacks?: Array<string>;
+
+  /**
+   * The maximum duration of the call in seconds. The minimum value is 30 and the
+   * maximum value is 14400 (4 hours). Default is 14400 seconds.
+   */
+  TimeLimit?: number;
+
+  /**
+   * The number of seconds to wait for the called party to answer the call before the
+   * call is canceled. The minimum value is 5 and the maximum value is 120. Default
+   * is 30 seconds.
+   */
+  timeout_seconds?: number;
+
+  /**
+   * Whether to trim any leading and trailing silence from the recording. Defaults to
+   * `trim-silence`.
+   */
+  Trim?: 'trim-silence' | 'do-not-trim';
+}
+
+export namespace TexmlInitiateAICallParams {
+  export interface CustomHeader {
+    /**
+     * The name of the custom header
+     */
+    name: string;
+
+    /**
+     * The value of the custom header
+     */
+    value: string;
+  }
+}
+
 export interface TexmlSecretsParams {
   /**
    * Name used as a reference for the secret, if the name already exists within the
@@ -68,7 +341,12 @@ export interface TexmlSecretsParams {
 Texml.Accounts = Accounts;
 
 export declare namespace Texml {
-  export { type TexmlSecretsResponse as TexmlSecretsResponse, type TexmlSecretsParams as TexmlSecretsParams };
+  export {
+    type TexmlInitiateAICallResponse as TexmlInitiateAICallResponse,
+    type TexmlSecretsResponse as TexmlSecretsResponse,
+    type TexmlInitiateAICallParams as TexmlInitiateAICallParams,
+    type TexmlSecretsParams as TexmlSecretsParams,
+  };
 
   export {
     Accounts as Accounts,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '6.35.0'; // x-release-please-version
+export const VERSION = '6.36.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.35.0";
+export declare const VERSION = "6.36.0";
 //# 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.35.0'; // x-release-please-version
+exports.VERSION = '6.36.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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