telnyx 7.16.0 → 7.18.0

package/src/resources/calls/actions.ts

@@ -38,7 +38,8 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Stop an AI assistant on the call.
+   * Stops the AI assistant currently engaged on the call. The call remains active
+   * and can continue with other call control commands.
    *
    * @example
    * ```ts
@@ -119,7 +120,9 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Updates client state
+   * Updates the client state associated with the call. Client state is an opaque
+   * value echoed back in subsequent webhooks for the call, letting you correlate
+   * events with your application's state.
    *
    * @example
    * ```ts
@@ -139,7 +142,8 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Put the call in a queue.
+   * Places the call into a queue, where it waits until it is removed or bridged to
+   * another leg. Queue behavior is configured through the request body.
    *
    * @example
    * ```ts
@@ -377,7 +381,8 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Removes the call from a queue.
+   * Removes the call from the queue it is currently waiting in. The call remains
+   * active and can be directed with further call commands.
    *
    * @example
    * ```ts
@@ -845,7 +850,8 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Stop real-time transcription.
+   * Stops real-time transcription on the call. Transcription webhooks cease once the
+   * command takes effect; the call itself is unaffected.
    *
    * @example
    * ```ts
@@ -1430,13 +1436,13 @@ export type Loopcount = string | number;
 /**
  * A default prompt string or an ordered list of qualified prompts.
  */
-export type PayPromptValue = string | Array<PayPromptValue.UnionMember1>;
+export type PayPromptValue = string | Array<PayPromptValue.PayPromptList>;
 
 export namespace PayPromptValue {
   /**
    * A text-to-speech prompt with optional matching qualifiers.
    */
-  export interface UnionMember1 {
+  export interface PayPromptList {
     /**
      * Text spoken for the payment collection step.
      */
@@ -1448,11 +1454,18 @@ export namespace PayPromptValue {
     attempt?: string;
 
     /**
-     * Lowercase, case-sensitive detected card type for which this prompt applies. Only
-     * the listed brands are currently detected; accepted UnionPay and Maestro test
-     * cards do not produce a card-type qualifier.
+     * Lowercase, case-sensitive detected card type for which this prompt applies.
      */
-    card_type?: 'visa' | 'mastercard' | 'amex' | 'discover' | 'diners-club' | 'jcb';
+    card_type?:
+      | 'visa'
+      | 'mastercard'
+      | 'amex'
+      | 'optima'
+      | 'discover'
+      | 'diners-club'
+      | 'jcb'
+      | 'maestro'
+      | 'enroute';
 
     /**
      * Step error for which this prompt applies.
@@ -1460,6 +1473,7 @@ export namespace PayPromptValue {
     error_type?:
       | 'timeout'
       | 'invalid-card-number'
+      | 'invalid-card-type'
       | 'invalid-date'
       | 'invalid-security-code'
       | 'invalid-postal-code'
@@ -1675,7 +1689,9 @@ export interface TranscriptionConfig {
    * `auto` when `language` is omitted — omitting it applies `en` instead. For
    * `reson8/turns`, supported values are `auto` (or unset) for automatic language
    * detection, and the language codes `nl`, `en`, `fr`, `fy`, `de`, `it`, `pl`,
-   * `pt`, `es`, and `sv` to fix the transcription language.
+   * `pt`, `es`, and `sv` to fix the transcription language. For `cohere/ar-stt`,
+   * supported values are `ar` and `en`; unlike other models, this model does not
+   * auto-detect and defaults to `ar` when `language` is omitted.
    */
   language?: string;
 
@@ -1697,6 +1713,7 @@ export interface TranscriptionConfig {
    *   Arabic/English code-switching support.
    * - `reson8/turns` for live streaming turn-based transcription of 10 European
    *   languages with automatic language detection.
+   * - `cohere/ar-stt` for non-streaming Arabic and English transcription.
    * - `azure/fast` and `azure/realtime`; Azure models require `region`, and
    *   unsupported regions require `api_key_ref`.
    * - `google/latest_long` for non-streaming multilingual transcription.
@@ -1718,6 +1735,7 @@ export interface TranscriptionConfig {
     | 'nvidia/parakeet-v3'
     | 'humain/realtime'
     | 'reson8/turns'
+    | 'cohere/ar-stt'
     | 'azure/fast'
     | 'azure/realtime'
     | 'google/latest_long'
@@ -1937,6 +1955,24 @@ export interface TranscriptionEngineBConfig {
   transcription_model?: 'openai/whisper-tiny' | 'openai/whisper-large-v3-turbo';
 }
 
+export interface TranscriptionEngineCohereConfig {
+  /**
+   * The language of the audio to be transcribed. Unlike other self-hosted models,
+   * Cohere does not auto-detect the language; `auto` is not supported.
+   */
+  language?: 'ar' | 'en';
+
+  /**
+   * Engine identifier for Cohere transcription service
+   */
+  transcription_engine?: 'Cohere';
+
+  /**
+   * The model to use for transcription.
+   */
+  transcription_model?: 'cohere/ar-stt';
+}
+
 export type TranscriptionEngineDeepgramConfig = DeepgramNova2Config | DeepgramNova3Config;
 
 export interface TranscriptionEngineGoogleConfig {
@@ -2016,6 +2052,24 @@ export namespace TranscriptionEngineGoogleConfig {
   }
 }
 
+export interface TranscriptionEngineHumainConfig {
+  /**
+   * The language of the audio to be transcribed. `codeswitch` enables Arabic/English
+   * code-switching. `auto` resolves server-side to code-switching.
+   */
+  language?: 'ar' | 'en' | 'codeswitch' | 'auto';
+
+  /**
+   * Engine identifier for Humain transcription service
+   */
+  transcription_engine?: 'Humain';
+
+  /**
+   * The model to use for transcription.
+   */
+  transcription_model?: 'humain/realtime';
+}
+
 export interface TranscriptionEngineParakeetConfig {
   /**
    * Whether to send also interim results. If set to false, only final results will
@@ -2034,6 +2088,24 @@ export interface TranscriptionEngineParakeetConfig {
   transcription_model?: 'nvidia/parakeet-v3';
 }
 
+export interface TranscriptionEngineReson8Config {
+  /**
+   * The language of the audio to be transcribed. `auto` (the default, also applied
+   * when `language` is omitted) enables automatic language detection.
+   */
+  language?: 'auto' | 'nl' | 'en' | 'fr' | 'fy' | 'de' | 'it' | 'pl' | 'pt' | 'es' | 'sv';
+
+  /**
+   * Engine identifier for Reson8 transcription service
+   */
+  transcription_engine?: 'Reson8';
+
+  /**
+   * The model to use for transcription.
+   */
+  transcription_model?: 'reson8/turns';
+}
+
 export interface TranscriptionEngineSonioxConfig {
   /**
    * Engine identifier for Soniox transcription service
@@ -2204,6 +2276,7 @@ export interface TranscriptionStartRequest {
     | 'Parakeet'
     | 'Humain'
     | 'Reson8'
+    | 'Cohere'
     | 'A'
     | 'B';
 
@@ -2216,8 +2289,9 @@ export interface TranscriptionStartRequest {
     | TranscriptionEngineSpeechmaticsConfig
     | TranscriptionEngineSonioxConfig
     | TranscriptionEngineParakeetConfig
-    | TranscriptionStartRequest.TranscriptionEngineHumainConfig
-    | TranscriptionStartRequest.TranscriptionEngineReson8Config
+    | TranscriptionEngineHumainConfig
+    | TranscriptionEngineReson8Config
+    | TranscriptionEngineCohereConfig
     | TranscriptionEngineAConfig
     | TranscriptionEngineBConfig
     | DeepgramNova2Config
@@ -2231,44 +2305,6 @@ export interface TranscriptionStartRequest {
   transcription_tracks?: string;
 }
 
-export namespace TranscriptionStartRequest {
-  export interface TranscriptionEngineHumainConfig {
-    /**
-     * The language of the audio to be transcribed. `codeswitch` enables Arabic/English
-     * code-switching. `auto` resolves server-side to code-switching.
-     */
-    language?: 'ar' | 'en' | 'codeswitch' | 'auto';
-
-    /**
-     * Engine identifier for Humain transcription service
-     */
-    transcription_engine?: 'Humain';
-
-    /**
-     * The model to use for transcription.
-     */
-    transcription_model?: 'humain/realtime';
-  }
-
-  export interface TranscriptionEngineReson8Config {
-    /**
-     * The language of the audio to be transcribed. `auto` (the default, also applied
-     * when `language` is omitted) enables automatic language detection.
-     */
-    language?: 'auto' | 'nl' | 'en' | 'fr' | 'fy' | 'de' | 'it' | 'pl' | 'pt' | 'es' | 'sv';
-
-    /**
-     * Engine identifier for Reson8 transcription service
-     */
-    transcription_engine?: 'Reson8';
-
-    /**
-     * The model to use for transcription.
-     */
-    transcription_model?: 'reson8/turns';
-  }
-}
-
 /**
  * Messages sent by an end user
  */
@@ -2520,8 +2556,10 @@ export interface ActionStartAIAssistantParams {
   participants?: Array<AIAssistantJoinParticipant>;
 
   /**
-   * When `true`, a webhook is sent each time the conversation message history is
-   * updated.
+   * When `true`, a `call.ai_gather.message_history_updated` webhook carrying the
+   * full message history is sent each time the conversation message history is
+   * updated. The assistant's own `telephony_settings.send_message_history_updates`
+   * overrides this value when it is set.
    */
   send_message_history_updates?: boolean;
 
@@ -3087,7 +3125,8 @@ export interface ActionGatherParams {
 
   /**
    * The digit used to terminate input if fewer than `maximum_digits` digits have
-   * been gathered.
+   * been gathered. Set to an empty string to disable the terminating digit entirely,
+   * so that a digit such as `#` can be collected as input per `valid_digits`.
    */
   terminating_digit?: string;
 
@@ -3246,7 +3285,6 @@ export interface ActionGatherUsingAIParams {
     | TelnyxVoiceSettings
     | AwsVoiceSettings
     | Shared.AzureVoiceSettings
-    | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.XaiVoiceSettings;
 }
@@ -3333,7 +3371,8 @@ export interface ActionGatherUsingAudioParams {
 
   /**
    * The digit used to terminate input if fewer than `maximum_digits` digits have
-   * been gathered.
+   * been gathered. Set to an empty string to disable the terminating digit entirely,
+   * so that a digit such as `#` can be collected as input per `valid_digits`.
    */
   terminating_digit?: string;
 
@@ -3390,9 +3429,6 @@ export interface ActionGatherUsingSpeakParams {
    *   `Minimax.speech-02-hd.Wise_Woman`). Supported models: `speech-02-turbo`,
    *   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
    *   to configure speed, volume, pitch, and language_boost.
-   * - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-   *   Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
-   *   `voice_settings` to configure voice_speed.
    * - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
    *   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
    *   `voice_settings` to configure precision, sample_rate, and format.
@@ -3505,7 +3541,8 @@ export interface ActionGatherUsingSpeakParams {
 
   /**
    * The digit used to terminate input if fewer than `maximum_digits` digits have
-   * been gathered.
+   * been gathered. Set to an empty string to disable the terminating digit entirely,
+   * so that a digit such as `#` can be collected as input per `valid_digits`.
    */
   terminating_digit?: string;
 
@@ -3529,7 +3566,6 @@ export interface ActionGatherUsingSpeakParams {
     | AwsVoiceSettings
     | Shared.MinimaxVoiceSettings
     | Shared.AzureVoiceSettings
-    | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
     | Shared.XaiVoiceSettings;
@@ -4283,9 +4319,6 @@ export interface ActionSpeakParams {
    *   `Minimax.speech-02-hd.Wise_Woman`). Supported models: `speech-02-turbo`,
    *   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
    *   to configure speed, volume, pitch, and language_boost.
-   * - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-   *   Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
-   *   `voice_settings` to configure voice_speed.
    * - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
    *   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
    *   `voice_settings` to configure precision, sample_rate, and format.
@@ -4395,7 +4428,6 @@ export interface ActionSpeakParams {
     | AwsVoiceSettings
     | Shared.MinimaxVoiceSettings
     | Shared.AzureVoiceSettings
-    | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
     | Shared.XaiVoiceSettings;
@@ -4653,6 +4685,7 @@ export interface ActionStartTranscriptionParams {
     | 'Parakeet'
     | 'Humain'
     | 'Reson8'
+    | 'Cohere'
     | 'A'
     | 'B';
 
@@ -4665,8 +4698,9 @@ export interface ActionStartTranscriptionParams {
     | TranscriptionEngineSpeechmaticsConfig
     | TranscriptionEngineSonioxConfig
     | TranscriptionEngineParakeetConfig
-    | ActionStartTranscriptionParams.TranscriptionEngineHumainConfig
-    | ActionStartTranscriptionParams.TranscriptionEngineReson8Config
+    | TranscriptionEngineHumainConfig
+    | TranscriptionEngineReson8Config
+    | TranscriptionEngineCohereConfig
     | TranscriptionEngineAConfig
     | TranscriptionEngineBConfig
     | DeepgramNova2Config
@@ -4680,44 +4714,6 @@ export interface ActionStartTranscriptionParams {
   transcription_tracks?: string;
 }
 
-export namespace ActionStartTranscriptionParams {
-  export interface TranscriptionEngineHumainConfig {
-    /**
-     * The language of the audio to be transcribed. `codeswitch` enables Arabic/English
-     * code-switching. `auto` resolves server-side to code-switching.
-     */
-    language?: 'ar' | 'en' | 'codeswitch' | 'auto';
-
-    /**
-     * Engine identifier for Humain transcription service
-     */
-    transcription_engine?: 'Humain';
-
-    /**
-     * The model to use for transcription.
-     */
-    transcription_model?: 'humain/realtime';
-  }
-
-  export interface TranscriptionEngineReson8Config {
-    /**
-     * The language of the audio to be transcribed. `auto` (the default, also applied
-     * when `language` is omitted) enables automatic language detection.
-     */
-    language?: 'auto' | 'nl' | 'en' | 'fr' | 'fy' | 'de' | 'it' | 'pl' | 'pt' | 'es' | 'sv';
-
-    /**
-     * Engine identifier for Reson8 transcription service
-     */
-    transcription_engine?: 'Reson8';
-
-    /**
-     * The model to use for transcription.
-     */
-    transcription_model?: 'reson8/turns';
-  }
-}
-
 export interface ActionStopTranscriptionParams {
   /**
    * Use this field to add state to every subsequent webhook. It must be a valid
@@ -5034,6 +5030,13 @@ export namespace ActionTransferParams {
      */
     after_greeting_silence_millis?: 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
+     * beeps whose volume is too unsteady for the default profile.
+     */
+    beep_detection_profile?: 'both' | 'freq_only';
+
     /**
      * Maximum threshold for silence between words.
      */
@@ -5237,8 +5240,7 @@ export interface ActionStartConversationRelayParams {
   structured_provider?: { [key: string]: unknown };
 
   /**
-   * @deprecated Not supported for Conversation Relay start requests. Use
-   * `transcription_engine` and `transcription_engine_config` instead.
+   * @deprecated Use transcription_engine and transcription_engine_config instead.
    */
   transcription?: { [key: string]: unknown };
 
@@ -5327,7 +5329,6 @@ export interface ActionStartConversationRelayParams {
     | AwsVoiceSettings
     | Shared.MinimaxVoiceSettings
     | Shared.AzureVoiceSettings
-    | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
     | Shared.XaiVoiceSettings;
@@ -5488,6 +5489,16 @@ export interface ActionPayParams {
    */
   transaction_type?: 'charge' | 'tokenize';
 
+  /**
+   * Restricts accepted card numbers to the listed card types. When the caller enters
+   * a card number that does not match one of the listed types, Pay treats the input
+   * as invalid and re-prompts for the card number. Cannot be used together with
+   * `payment_token`.
+   */
+  valid_card_types?: Array<
+    'visa' | 'mastercard' | 'amex' | 'maestro' | 'discover' | 'optima' | 'jcb' | 'diners-club' | 'enroute'
+  >;
+
   /**
    * Voice used for payment prompts. Accepts `male`, `female`, or a provider voice in
    * `<Provider>.<Model>.<VoiceId>` format, for example `AWS.Polly.Joanna` or
@@ -5559,9 +5570,12 @@ export declare namespace Actions {
     type TranscriptionEngineAssemblyaiConfig as TranscriptionEngineAssemblyaiConfig,
     type TranscriptionEngineAzureConfig as TranscriptionEngineAzureConfig,
     type TranscriptionEngineBConfig as TranscriptionEngineBConfig,
+    type TranscriptionEngineCohereConfig as TranscriptionEngineCohereConfig,
     type TranscriptionEngineDeepgramConfig as TranscriptionEngineDeepgramConfig,
     type TranscriptionEngineGoogleConfig as TranscriptionEngineGoogleConfig,
+    type TranscriptionEngineHumainConfig as TranscriptionEngineHumainConfig,
     type TranscriptionEngineParakeetConfig as TranscriptionEngineParakeetConfig,
+    type TranscriptionEngineReson8Config as TranscriptionEngineReson8Config,
     type TranscriptionEngineSonioxConfig as TranscriptionEngineSonioxConfig,
     type TranscriptionEngineSpeechmaticsConfig as TranscriptionEngineSpeechmaticsConfig,
     type TranscriptionEngineTelnyxConfig as TranscriptionEngineTelnyxConfig,

package/src/resources/calls/calls.ts

@@ -111,9 +111,12 @@ import {
   TranscriptionEngineAssemblyaiConfig,
   TranscriptionEngineAzureConfig,
   TranscriptionEngineBConfig,
+  TranscriptionEngineCohereConfig,
   TranscriptionEngineDeepgramConfig,
   TranscriptionEngineGoogleConfig,
+  TranscriptionEngineHumainConfig,
   TranscriptionEngineParakeetConfig,
+  TranscriptionEngineReson8Config,
   TranscriptionEngineSonioxConfig,
   TranscriptionEngineSpeechmaticsConfig,
   TranscriptionEngineTelnyxConfig,
@@ -551,7 +554,6 @@ export interface ConversationRelayEmbeddedConfig {
     | ActionsAPI.AwsVoiceSettings
     | Shared.MinimaxVoiceSettings
     | Shared.AzureVoiceSettings
-    | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
     | Shared.XaiVoiceSettings;
@@ -657,7 +659,6 @@ export interface ConversationRelayLanguage {
     | ActionsAPI.AwsVoiceSettings
     | Shared.MinimaxVoiceSettings
     | Shared.AzureVoiceSettings
-    | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
     | Shared.XaiVoiceSettings;
@@ -1318,6 +1319,13 @@ export namespace CallDialParams {
      */
     after_greeting_silence_millis?: 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
+     * beeps whose volume is too unsteady for the default profile.
+     */
+    beep_detection_profile?: 'both' | 'freq_only';
+
     /**
      * Maximum threshold for silence between words.
      */
@@ -1548,9 +1556,12 @@ export declare namespace Calls {
     type TranscriptionEngineAssemblyaiConfig as TranscriptionEngineAssemblyaiConfig,
     type TranscriptionEngineAzureConfig as TranscriptionEngineAzureConfig,
     type TranscriptionEngineBConfig as TranscriptionEngineBConfig,
+    type TranscriptionEngineCohereConfig as TranscriptionEngineCohereConfig,
     type TranscriptionEngineDeepgramConfig as TranscriptionEngineDeepgramConfig,
     type TranscriptionEngineGoogleConfig as TranscriptionEngineGoogleConfig,
+    type TranscriptionEngineHumainConfig as TranscriptionEngineHumainConfig,
     type TranscriptionEngineParakeetConfig as TranscriptionEngineParakeetConfig,
+    type TranscriptionEngineReson8Config as TranscriptionEngineReson8Config,
     type TranscriptionEngineSonioxConfig as TranscriptionEngineSonioxConfig,
     type TranscriptionEngineSpeechmaticsConfig as TranscriptionEngineSpeechmaticsConfig,
     type TranscriptionEngineTelnyxConfig as TranscriptionEngineTelnyxConfig,

package/src/resources/calls/index.ts

@@ -26,9 +26,12 @@ export {
   type TranscriptionEngineAssemblyaiConfig,
   type TranscriptionEngineAzureConfig,
   type TranscriptionEngineBConfig,
+  type TranscriptionEngineCohereConfig,
   type TranscriptionEngineDeepgramConfig,
   type TranscriptionEngineGoogleConfig,
+  type TranscriptionEngineHumainConfig,
   type TranscriptionEngineParakeetConfig,
+  type TranscriptionEngineReson8Config,
   type TranscriptionEngineSonioxConfig,
   type TranscriptionEngineSpeechmaticsConfig,
   type TranscriptionEngineTelnyxConfig,

package/src/resources/conferences/actions.ts

@@ -102,7 +102,8 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Pause conference recording.
+   * Pauses the active recording of the specified conference. Resume it later with
+   * the record_resume action.
    *
    * @example
    * ```ts
@@ -119,7 +120,8 @@ export class Actions extends APIResource {
   }
 
   /**
-   * Resume conference recording.
+   * Resumes a previously paused recording of the specified conference, continuing
+   * capture from the point it was paused.
    *
    * @example
    * ```ts
@@ -785,9 +787,6 @@ export interface ActionSpeakParams {
    *   `Minimax.speech-02-hd.Wise_Woman`). Supported models: `speech-02-turbo`,
    *   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
    *   to configure speed, volume, pitch, and language_boost.
-   * - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-   *   Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
-   *   `voice_settings` to configure voice_speed.
    * - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
    *   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
    *   `voice_settings` to configure precision, sample_rate, and format.
@@ -879,7 +878,6 @@ export interface ActionSpeakParams {
     | ActionsAPI.AwsVoiceSettings
     | Shared.MinimaxVoiceSettings
     | Shared.AzureVoiceSettings
-    | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
     | Shared.XaiVoiceSettings;
@@ -1043,7 +1041,9 @@ export interface ActionGatherDtmfAudioParams {
   stop_playback_on_dtmf?: boolean;
 
   /**
-   * Digit that terminates gathering.
+   * Digit that terminates gathering. Set to an empty string to disable the
+   * terminating digit entirely, so that a digit such as `#` can be collected as
+   * input per `valid_digits`.
    */
   terminating_digit?: string;
 

package/src/resources/conferences/conferences.ts

@@ -104,7 +104,8 @@ export class Conferences extends APIResource {
   }
 
   /**
-   * Lists conference participants
+   * Returns a paginated list of participants in the specified conference, with
+   * support for filtering.
    *
    * @example
    * ```ts
@@ -132,7 +133,7 @@ export class Conferences extends APIResource {
   }
 
   /**
-   * Retrieve an existing conference
+   * Returns the details of an existing conference, including its current status.
    *
    * @example
    * ```ts

package/src/resources/country-coverage.ts

@@ -10,14 +10,16 @@ import { path } from '../internal/utils/path';
  */
 export class CountryCoverageResource extends APIResource {
   /**
-   * Get country coverage
+   * Returns Telnyx service coverage information for every country, including which
+   * number types and features are available in each.
    */
   retrieve(options?: RequestOptions): APIPromise<CountryCoverageRetrieveResponse> {
     return this._client.get('/country_coverage', options);
   }
 
   /**
-   * Get coverage for a specific country
+   * Returns Telnyx service coverage information for the specified country, including
+   * available number types and features.
    */
   retrieveCountry(
     countryCode: string,

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

@@ -37,7 +37,8 @@ export class CredentialConnections extends APIResource {
   }
 
   /**
-   * Creates a credential connection.
+   * Creates a new credential-based SIP connection. Credential connections
+   * authenticate with a username and password rather than by IP address.
    *
    * @example
    * ```ts