telnyx 6.83.0 → 7.1.0

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

@@ -2,14 +2,16 @@
 
 import { APIResource } from '../../../../core/resource';
 import * as RecordingsAPI from './recordings';
-import { RecordingRecordingSidJsonParams, RecordingRecordingSidJsonResponse, Recordings } from './recordings';
+import { RecordingRecordingSidJsonParams, Recordings } from './recordings';
 import * as RecordingsJsonAPI from './recordings-json';
 import {
+  RecordingSource,
   RecordingsJson,
   RecordingsJsonRecordingsJsonParams,
-  RecordingsJsonRecordingsJsonResponse,
   RecordingsJsonRetrieveRecordingsJsonParams,
-  RecordingsJsonRetrieveRecordingsJsonResponse,
+  TexmlCreateCallRecordingResponseBody,
+  TexmlGetCallRecordingsResponseBody,
+  TwimlRecordingChannels,
 } from './recordings-json';
 import * as SiprecAPI from './siprec';
 import { Siprec, SiprecSiprecSidJsonParams, SiprecSiprecSidJsonResponse } from './siprec';
@@ -35,17 +37,13 @@ export class Calls extends APIResource {
    *
    * @example
    * ```ts
-   * const call = await client.texml.accounts.calls.retrieve(
-   *   'call_sid',
-   *   { account_sid: 'account_sid' },
-   * );
+   * const callResource =
+   *   await client.texml.accounts.calls.retrieve('call_sid', {
+   *     account_sid: 'account_sid',
+   *   });
    * ```
    */
-  retrieve(
-    callSid: string,
-    params: CallRetrieveParams,
-    options?: RequestOptions,
-  ): APIPromise<CallRetrieveResponse> {
+  retrieve(callSid: string, params: CallRetrieveParams, options?: RequestOptions): APIPromise<CallResource> {
     const { account_sid } = params;
     return this._client.get(path`/texml/Accounts/${account_sid}/Calls/${callSid}`, options);
   }
@@ -56,17 +54,13 @@ export class Calls extends APIResource {
    *
    * @example
    * ```ts
-   * const call = await client.texml.accounts.calls.update(
-   *   'call_sid',
-   *   { account_sid: 'account_sid' },
-   * );
+   * const callResource =
+   *   await client.texml.accounts.calls.update('call_sid', {
+   *     account_sid: 'account_sid',
+   *   });
    * ```
    */
-  update(
-    callSid: string,
-    params: CallUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<CallUpdateResponse> {
+  update(callSid: string, params: CallUpdateParams, options?: RequestOptions): APIPromise<CallResource> {
     const { account_sid, ...body } = params;
     return this._client.post(path`/texml/Accounts/${account_sid}/Calls/${callSid}`, {
       body,
@@ -83,19 +77,20 @@ export class Calls extends APIResource {
    * ```ts
    * const response = await client.texml.accounts.calls.calls(
    *   'account_sid',
-   *   {
-   *     params: {
-   *       ApplicationSid: 'example-app-sid',
-   *       From: '+13120001234',
-   *       To: '+13121230000',
-   *     },
-   *   },
+   *   { Url: 'https://www.example.com/instructions.xml' },
    * );
    * ```
    */
-  calls(accountSid: string, args: CallCallsParams, options?: RequestOptions): APIPromise<CallCallsResponse> {
-    const { params } = args;
-    return this._client.post(path`/texml/Accounts/${accountSid}/Calls`, { body: params, ...options });
+  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,
+    });
   }
 
   /**
@@ -169,52 +164,7 @@ export class Calls extends APIResource {
   }
 }
 
-export interface UpdateCall {
-  /**
-   * HTTP request type used for `FallbackUrl`.
-   */
-  FallbackMethod?: 'GET' | 'POST';
-
-  /**
-   * A failover URL for which Telnyx will retrieve the TeXML call instructions if the
-   * Url is not responding.
-   */
-  FallbackUrl?: string;
-
-  /**
-   * HTTP request type used for `Url`.
-   */
-  Method?: 'GET' | 'POST';
-
-  /**
-   * The value to set the call status to. Setting the status to completed ends the
-   * call.
-   */
-  Status?: string;
-
-  /**
-   * URL destination for Telnyx to send status callback events to for the call.
-   */
-  StatusCallback?: string;
-
-  /**
-   * HTTP request type used for `StatusCallback`.
-   */
-  StatusCallbackMethod?: 'GET' | 'POST';
-
-  /**
-   * TeXML to replace the current one with.
-   */
-  Texml?: string;
-
-  /**
-   * The URL where TeXML will make a request to retrieve a new set of TeXML
-   * instructions to continue the call flow.
-   */
-  Url?: string;
-}
-
-export interface CallRetrieveResponse {
+export interface CallResource {
   /**
    * The id of the account the resource belongs to.
    */
@@ -308,98 +258,49 @@ export interface CallRetrieveResponse {
   uri?: string;
 }
 
-export interface CallUpdateResponse {
-  /**
-   * The id of the account the resource belongs to.
-   */
-  account_sid?: string;
-
-  /**
-   * The value of the answering machine detection result, if this feature was enabled
-   * for the call.
-   */
-  answered_by?: 'human' | 'machine' | 'not_sure';
-
-  /**
-   * Caller ID, if present.
-   */
-  caller_name?: string;
-
-  /**
-   * The timestamp of when the resource was created.
-   */
-  date_created?: string;
-
-  /**
-   * The timestamp of when the resource was last updated.
-   */
-  date_updated?: string;
-
-  /**
-   * The direction of this call.
-   */
-  direction?: 'inbound' | 'outbound';
-
-  /**
-   * The duration of this call, given in seconds.
-   */
-  duration?: string;
-
-  /**
-   * The end time of this call.
-   */
-  end_time?: string;
-
-  /**
-   * The phone number or SIP address that made this call.
-   */
-  from?: string;
-
-  /**
-   * The from number formatted for display.
-   */
-  from_formatted?: string;
-
+export interface UpdateCall {
   /**
-   * The price of this call, the currency is specified in the price_unit field. Only
-   * populated when the call cost feature is enabled for the account.
+   * HTTP request type used for `FallbackUrl`.
    */
-  price?: string;
+  FallbackMethod?: 'GET' | 'POST';
 
   /**
-   * The unit in which the price is given.
+   * A failover URL for which Telnyx will retrieve the TeXML call instructions if the
+   * Url is not responding.
    */
-  price_unit?: string;
+  FallbackUrl?: string;
 
   /**
-   * The identifier of this call.
+   * HTTP request type used for `Url`.
    */
-  sid?: string;
+  Method?: 'GET' | 'POST';
 
   /**
-   * The start time of this call.
+   * The value to set the call status to. Setting the status to completed ends the
+   * call.
    */
-  start_time?: string;
+  Status?: string;
 
   /**
-   * The status of this call.
+   * URL destination for Telnyx to send status callback events to for the call.
    */
-  status?: 'ringing' | 'in-progress' | 'canceled' | 'completed' | 'failed' | 'busy' | 'no-answer';
+  StatusCallback?: string;
 
   /**
-   * The phone number or SIP address that received this call.
+   * HTTP request type used for `StatusCallback`.
    */
-  to?: string;
+  StatusCallbackMethod?: 'GET' | 'POST';
 
   /**
-   * The to number formatted for display.
+   * TeXML to replace the current one with.
    */
-  to_formatted?: string;
+  Texml?: string;
 
   /**
-   * The relative URI for this call.
+   * The URL where TeXML will make a request to retrieve a new set of TeXML
+   * instructions to continue the call flow.
    */
-  uri?: string;
+  Url?: string;
 }
 
 export interface CallCallsResponse {
@@ -411,7 +312,7 @@ export interface CallCallsResponse {
 }
 
 export interface CallRetrieveCallsResponse {
-  calls?: Array<CallRetrieveCallsResponse.Call>;
+  calls?: Array<CallResource>;
 
   /**
    * The number of the last element on the page, zero-indexed.
@@ -449,102 +350,6 @@ export interface CallRetrieveCallsResponse {
   uri?: string;
 }
 
-export namespace CallRetrieveCallsResponse {
-  export interface Call {
-    /**
-     * The id of the account the resource belongs to.
-     */
-    account_sid?: string;
-
-    /**
-     * The value of the answering machine detection result, if this feature was enabled
-     * for the call.
-     */
-    answered_by?: 'human' | 'machine' | 'not_sure';
-
-    /**
-     * Caller ID, if present.
-     */
-    caller_name?: string;
-
-    /**
-     * The timestamp of when the resource was created.
-     */
-    date_created?: string;
-
-    /**
-     * The timestamp of when the resource was last updated.
-     */
-    date_updated?: string;
-
-    /**
-     * The direction of this call.
-     */
-    direction?: 'inbound' | 'outbound';
-
-    /**
-     * The duration of this call, given in seconds.
-     */
-    duration?: string;
-
-    /**
-     * The end time of this call.
-     */
-    end_time?: string;
-
-    /**
-     * The phone number or SIP address that made this call.
-     */
-    from?: string;
-
-    /**
-     * The from number formatted for display.
-     */
-    from_formatted?: string;
-
-    /**
-     * The price of this call, the currency is specified in the price_unit field. Only
-     * populated when the call cost feature is enabled for the account.
-     */
-    price?: string;
-
-    /**
-     * The unit in which the price is given.
-     */
-    price_unit?: string;
-
-    /**
-     * The identifier of this call.
-     */
-    sid?: string;
-
-    /**
-     * The start time of this call.
-     */
-    start_time?: string;
-
-    /**
-     * The status of this call.
-     */
-    status?: 'ringing' | 'in-progress' | 'canceled' | 'completed' | 'failed' | 'busy' | 'no-answer';
-
-    /**
-     * The phone number or SIP address that received this call.
-     */
-    to?: string;
-
-    /**
-     * The to number formatted for display.
-     */
-    to_formatted?: string;
-
-    /**
-     * The relative URI for this call.
-     */
-    uri?: string;
-  }
-}
-
 export interface CallSiprecJsonResponse {
   /**
    * The id of the account the resource belongs to.
@@ -683,38 +488,22 @@ export interface CallUpdateParams {
   Url?: string;
 }
 
-export interface CallCallsParams {
-  /**
-   * Initiate a TeXML call. Provide either `Url` (fetches TeXML from URL) or `Texml`
-   * (inline TeXML), or neither (uses the application default). `Url` and `Texml` are
-   * mutually exclusive.
-   */
-  params: CallCallsParams.Params;
-}
-
-export namespace CallCallsParams {
-  /**
-   * Initiate a TeXML call. Provide either `Url` (fetches TeXML from URL) or `Texml`
-   * (inline TeXML), or neither (uses the application default). `Url` and `Texml` are
-   * mutually exclusive.
-   */
-  export interface Params {
-    /**
-     * The ID of the TeXML Application.
-     */
-    ApplicationSid: string;
+export type CallCallsParams =
+  | CallCallsParams.WithURL
+  | CallCallsParams.WithTeXml
+  | CallCallsParams.ApplicationDefault;
 
+export declare namespace CallCallsParams {
+  export interface WithURL {
     /**
-     * The phone number of the party that initiated the call. Phone numbers are
-     * formatted with a `+` and country code.
+     * The URL from which Telnyx will retrieve the TeXML call instructions.
      */
-    From: string;
+    Url: string;
 
     /**
-     * The phone number of the called party. Phone numbers are formatted with a `+` and
-     * country code.
+     * The ID of the TeXML Application.
      */
-    To: string;
+    ApplicationSid?: string;
 
     /**
      * Select whether to perform answering machine detection in the background. By
@@ -756,7 +545,7 @@ export namespace CallCallsParams {
      * Custom HTTP headers to be sent with the call. Each header should be an object
      * with 'name' and 'value' properties.
      */
-    CustomHeaders?: Array<Params.CustomHeader>;
+    CustomHeaders?: Array<WithURL.CustomHeader>;
 
     /**
      * Enables Deepfake Detection on the dialed call. When enabled, audio from the
@@ -789,6 +578,12 @@ export namespace CallCallsParams {
      */
     FallbackUrl?: string;
 
+    /**
+     * The phone number of the party that initiated the call. Phone numbers are
+     * formatted with a `+` and country code.
+     */
+    From?: string;
+
     /**
      * Enables Answering Machine Detection.
      */
@@ -926,11 +721,7 @@ export namespace CallCallsParams {
      */
     SupervisingRole?: 'barge' | 'whisper' | 'monitor';
 
-    /**
-     * TeXML to be used as instructions for the call. If provided, the call will
-     * execute these instructions instead of fetching from the Url.
-     */
-    Texml?: string;
+    Texml?: string | null;
 
     /**
      * The maximum duration of the call in seconds. The minimum value is 30 and the
@@ -943,7 +734,13 @@ export namespace CallCallsParams {
      * call is canceled. The minimum value is 5 and the maximum value is 120. Default
      * is 30 seconds.
      */
-    Timeout?: number;
+    timeout_seconds?: number;
+
+    /**
+     * The phone number of the called party. Phone numbers are formatted with a `+` and
+     * country code.
+     */
+    To?: string;
 
     /**
      * Whether to trim any leading and trailing silence from the recording. Defaults to
@@ -952,9 +749,552 @@ export namespace CallCallsParams {
     Trim?: 'trim-silence' | 'do-not-trim';
 
     /**
-     * The URL from which Telnyx will retrieve the TeXML call instructions.
+     * HTTP request type used for `Url`. The default value is inherited from TeXML
+     * Application setting.
+     */
+    UrlMethod?: 'GET' | 'POST';
+  }
+
+  export namespace WithURL {
+    export interface CustomHeader {
+      /**
+       * The name of the custom header
+       */
+      name: string;
+
+      /**
+       * The value of the custom header
+       */
+      value: string;
+    }
+  }
+
+  export interface WithTeXml {
+    /**
+     * TeXML to be used as instructions for the call. If provided, the call will
+     * execute these instructions instead of fetching from the Url.
      */
-    Url?: string;
+    Texml: string;
+
+    /**
+     * The ID of the TeXML Application.
+     */
+    ApplicationSid?: 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`. The default value is
+     * inherited from TeXML Application setting.
+     */
+    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
+     * ommited, the display name will be the same as the number in the `From` field.
+     */
+    CallerId?: string;
+
+    /**
+     * Whether to cancel ongoing playback on `greeting ended` detection. Defaults to
+     * `true`.
+     */
+    CancelPlaybackOnDetectMessageEnd?: boolean;
+
+    /**
+     * Whether to cancel ongoing playback on `machine` detection. Defaults to `true`.
+     */
+    CancelPlaybackOnMachineDetection?: boolean;
+
+    /**
+     * Custom HTTP headers to be sent with the call. Each header should be an object
+     * with 'name' and 'value' properties.
+     */
+    CustomHeaders?: Array<WithTeXml.CustomHeader>;
+
+    /**
+     * Enables Deepfake Detection on the dialed call. When enabled, audio from the
+     * remote party is analyzed to determine whether the voice is AI-generated. Results
+     * are delivered asynchronously via a callback.
+     */
+    DeepfakeDetection?: 'Enable';
+
+    /**
+     * HTTP request type used for `DeepfakeDetectionCallbackUrl`.
+     */
+    DeepfakeDetectionCallbackMethod?: 'GET' | 'POST';
+
+    /**
+     * URL destination for Telnyx to send deepfake detection callback events to for the
+     * call.
+     */
+    DeepfakeDetectionCallbackUrl?: string;
+
+    /**
+     * Allows you to choose between Regular, Premium, and PremiumCallScreening
+     * detections. See
+     * https://developers.telnyx.com/docs/voice/programmable-voice/answering-machine-detection
+     */
+    DetectionMode?: 'Premium' | 'Regular' | 'PremiumCallScreening';
+
+    /**
+     * A failover URL for which Telnyx will retrieve the TeXML call instructions if the
+     * `Url` is not responding.
+     */
+    FallbackUrl?: string;
+
+    /**
+     * The phone number of the party that initiated the call. Phone numbers are
+     * formatted with a `+` and country code.
+     */
+    From?: string;
+
+    /**
+     * Enables Answering Machine Detection.
+     */
+    MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
+
+    /**
+     * Silence duration threshold after a call screening prompt before ending prompt
+     * detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.
+     */
+    MachineDetectionPromptEndTimeout?: number;
+
+    /**
+     * 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;
+
+    /**
+     * 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.
+     */
+    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
+     * `RecoridngStatusCallback`. 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. Please
+     * note that the transcription is used to detect silence and the related charge
+     * will be applied. 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.
+     */
+    StatusCallbackEvent?: 'initiated' | 'ringing' | 'answered' | 'completed';
+
+    /**
+     * HTTP request type used for `StatusCallback`.
+     */
+    StatusCallbackMethod?: 'GET' | 'POST';
+
+    /**
+     * The call control ID of the existing call to supervise. When provided, the
+     * created leg will be added to the specified call in supervising mode. Status
+     * callbacks and action callbacks will NOT be sent for the supervising leg.
+     */
+    SuperviseCallSid?: string;
+
+    /**
+     * The supervising role for the new leg. Determines the audio behavior: barge (hear
+     * both sides), whisper (only hear supervisor), monitor (hear both sides but
+     * supervisor muted). Default: barge
+     */
+    SupervisingRole?: 'barge' | 'whisper' | 'monitor';
+
+    /**
+     * 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;
+
+    /**
+     * The phone number of the called party. Phone numbers are formatted with a `+` and
+     * country code.
+     */
+    To?: string;
+
+    /**
+     * Whether to trim any leading and trailing silence from the recording. Defaults to
+     * `trim-silence`.
+     */
+    Trim?: 'trim-silence' | 'do-not-trim';
+
+    Url?: string | null;
+
+    /**
+     * HTTP request type used for `Url`. The default value is inherited from TeXML
+     * Application setting.
+     */
+    UrlMethod?: 'GET' | 'POST';
+  }
+
+  export namespace WithTeXml {
+    export interface CustomHeader {
+      /**
+       * The name of the custom header
+       */
+      name: string;
+
+      /**
+       * The value of the custom header
+       */
+      value: string;
+    }
+  }
+
+  export interface ApplicationDefault {
+    /**
+     * The ID of the TeXML Application.
+     */
+    ApplicationSid?: 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`. The default value is
+     * inherited from TeXML Application setting.
+     */
+    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
+     * ommited, the display name will be the same as the number in the `From` field.
+     */
+    CallerId?: string;
+
+    /**
+     * Whether to cancel ongoing playback on `greeting ended` detection. Defaults to
+     * `true`.
+     */
+    CancelPlaybackOnDetectMessageEnd?: boolean;
+
+    /**
+     * Whether to cancel ongoing playback on `machine` detection. Defaults to `true`.
+     */
+    CancelPlaybackOnMachineDetection?: boolean;
+
+    /**
+     * Custom HTTP headers to be sent with the call. Each header should be an object
+     * with 'name' and 'value' properties.
+     */
+    CustomHeaders?: Array<ApplicationDefault.CustomHeader>;
+
+    /**
+     * Enables Deepfake Detection on the dialed call. When enabled, audio from the
+     * remote party is analyzed to determine whether the voice is AI-generated. Results
+     * are delivered asynchronously via a callback.
+     */
+    DeepfakeDetection?: 'Enable';
+
+    /**
+     * HTTP request type used for `DeepfakeDetectionCallbackUrl`.
+     */
+    DeepfakeDetectionCallbackMethod?: 'GET' | 'POST';
+
+    /**
+     * URL destination for Telnyx to send deepfake detection callback events to for the
+     * call.
+     */
+    DeepfakeDetectionCallbackUrl?: string;
+
+    /**
+     * Allows you to choose between Regular, Premium, and PremiumCallScreening
+     * detections. See
+     * https://developers.telnyx.com/docs/voice/programmable-voice/answering-machine-detection
+     */
+    DetectionMode?: 'Premium' | 'Regular' | 'PremiumCallScreening';
+
+    /**
+     * A failover URL for which Telnyx will retrieve the TeXML call instructions if the
+     * `Url` is not responding.
+     */
+    FallbackUrl?: string;
+
+    /**
+     * The phone number of the party that initiated the call. Phone numbers are
+     * formatted with a `+` and country code.
+     */
+    From?: string;
+
+    /**
+     * Enables Answering Machine Detection.
+     */
+    MachineDetection?: 'Enable' | 'Disable' | 'DetectMessageEnd';
+
+    /**
+     * Silence duration threshold after a call screening prompt before ending prompt
+     * detection, in milliseconds. Used when `DetectionMode` is `PremiumCallScreening`.
+     */
+    MachineDetectionPromptEndTimeout?: number;
+
+    /**
+     * 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;
+
+    /**
+     * 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.
+     */
+    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
+     * `RecoridngStatusCallback`. 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. Please
+     * note that the transcription is used to detect silence and the related charge
+     * will be applied. 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.
+     */
+    StatusCallbackEvent?: 'initiated' | 'ringing' | 'answered' | 'completed';
+
+    /**
+     * HTTP request type used for `StatusCallback`.
+     */
+    StatusCallbackMethod?: 'GET' | 'POST';
+
+    /**
+     * The call control ID of the existing call to supervise. When provided, the
+     * created leg will be added to the specified call in supervising mode. Status
+     * callbacks and action callbacks will NOT be sent for the supervising leg.
+     */
+    SuperviseCallSid?: string;
+
+    /**
+     * The supervising role for the new leg. Determines the audio behavior: barge (hear
+     * both sides), whisper (only hear supervisor), monitor (hear both sides but
+     * supervisor muted). Default: barge
+     */
+    SupervisingRole?: 'barge' | 'whisper' | 'monitor';
+
+    Texml?: string | null;
+
+    /**
+     * 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;
+
+    /**
+     * The phone number of the called party. Phone numbers are formatted with a `+` and
+     * country code.
+     */
+    To?: string;
+
+    /**
+     * Whether to trim any leading and trailing silence from the recording. Defaults to
+     * `trim-silence`.
+     */
+    Trim?: 'trim-silence' | 'do-not-trim';
+
+    Url?: string | null;
 
     /**
      * HTTP request type used for `Url`. The default value is inherited from TeXML
@@ -963,7 +1303,7 @@ export namespace CallCallsParams {
     UrlMethod?: 'GET' | 'POST';
   }
 
-  export namespace Params {
+  export namespace ApplicationDefault {
     export interface CustomHeader {
       /**
        * The name of the custom header
@@ -1152,9 +1492,8 @@ Calls.Streams = Streams;
 
 export declare namespace Calls {
   export {
+    type CallResource as CallResource,
     type UpdateCall as UpdateCall,
-    type CallRetrieveResponse as CallRetrieveResponse,
-    type CallUpdateResponse as CallUpdateResponse,
     type CallCallsResponse as CallCallsResponse,
     type CallRetrieveCallsResponse as CallRetrieveCallsResponse,
     type CallSiprecJsonResponse as CallSiprecJsonResponse,
@@ -1169,15 +1508,16 @@ export declare namespace Calls {
 
   export {
     RecordingsJson as RecordingsJson,
-    type RecordingsJsonRecordingsJsonResponse as RecordingsJsonRecordingsJsonResponse,
-    type RecordingsJsonRetrieveRecordingsJsonResponse as RecordingsJsonRetrieveRecordingsJsonResponse,
+    type RecordingSource as RecordingSource,
+    type TexmlCreateCallRecordingResponseBody as TexmlCreateCallRecordingResponseBody,
+    type TexmlGetCallRecordingsResponseBody as TexmlGetCallRecordingsResponseBody,
+    type TwimlRecordingChannels as TwimlRecordingChannels,
     type RecordingsJsonRecordingsJsonParams as RecordingsJsonRecordingsJsonParams,
     type RecordingsJsonRetrieveRecordingsJsonParams as RecordingsJsonRetrieveRecordingsJsonParams,
   };
 
   export {
     Recordings as Recordings,
-    type RecordingRecordingSidJsonResponse as RecordingRecordingSidJsonResponse,
     type RecordingRecordingSidJsonParams as RecordingRecordingSidJsonParams,
   };