telnyx 7.7.0 → 7.9.0

package/src/resources/ai/conversations/index.ts

@@ -1,5 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  ConversationInsights,
+  type ConversationInsightRetrieveAggregatesResponse,
+  type ConversationInsightRetrieveAggregatesParams,
+} from './conversation-insights';
 export {
   Conversations,
   type Conversation,

package/src/resources/ai/index.ts

@@ -4,13 +4,12 @@ export {
   AI,
   type ModelMetadata,
   type ModelsResponse,
-  type AICreateResponseDeprecatedResponse,
   type AIRetrieveConversationHistoriesResponse,
   type AISummarizeResponse,
   type AISummarizeParams,
-  type AICreateResponseDeprecatedParams,
   type AIRetrieveConversationHistoriesParams,
 } from './ai';
+export { Anthropic } from './anthropic/index';
 export {
   Assistants,
   type ArithmeticExpression,
@@ -69,13 +68,7 @@ export {
   type AssistantSendSMSParams,
 } from './assistants/index';
 export { Audio, type AudioTranscribeResponse, type AudioTranscribeParams } from './audio';
-export {
-  Chat,
-  type BucketIDs,
-  type ChatCompletionRequest,
-  type ChatCreateCompletionResponse,
-  type ChatCreateCompletionParams,
-} from './chat';
+export { Chat, type BucketIDs, type ChatCompletionRequest } from './chat';
 export {
   Clusters,
   type RecursiveCluster,
@@ -138,6 +131,7 @@ export {
 export { OpenAI, type OpenAICreateResponseResponse, type OpenAICreateResponseParams } from './openai/index';
 export {
   Tools,
+  type PayToolParams,
   type SharedToolResponse,
   type ToolDeleteResponse,
   type ToolListParams,

package/src/resources/ai/tools.ts

@@ -89,6 +89,29 @@ export class Tools extends APIResource {
 
 export type SharedToolResponsesDefaultFlatPagination = DefaultFlatPagination<SharedToolResponse>;
 
+export interface PayToolParams {
+  /**
+   * The name of the pay connector configured in the Telnyx API. Must reference an
+   * existing pay connector for this organization.
+   */
+  connector_name: string;
+
+  /**
+   * Default currency for payments processed by this tool.
+   */
+  currency?: string;
+
+  /**
+   * Optional description of the pay tool that will be passed to the assistant.
+   */
+  description?: string | null;
+
+  /**
+   * Default payment method for payments processed by this tool.
+   */
+  payment_method?: string;
+}
+
 export interface SharedToolResponse {
   id: string;
 
@@ -122,12 +145,16 @@ export interface ToolCreateParams {
 
   type: string;
 
+  client_side_tool?: { [key: string]: unknown };
+
   function?: { [key: string]: unknown };
 
   handoff?: { [key: string]: unknown };
 
   invite?: { [key: string]: unknown };
 
+  pay?: PayToolParams;
+
   retrieval?: { [key: string]: unknown };
 
   timeout_ms?: number;
@@ -138,6 +165,8 @@ export interface ToolCreateParams {
 }
 
 export interface ToolUpdateParams {
+  client_side_tool?: { [key: string]: unknown };
+
   display_name?: string;
 
   function?: { [key: string]: unknown };
@@ -146,6 +175,8 @@ export interface ToolUpdateParams {
 
   invite?: { [key: string]: unknown };
 
+  pay?: PayToolParams;
+
   retrieval?: { [key: string]: unknown };
 
   timeout_ms?: number;
@@ -159,6 +190,7 @@ export interface ToolUpdateParams {
 
 export declare namespace Tools {
   export {
+    type PayToolParams as PayToolParams,
     type SharedToolResponse as SharedToolResponse,
     type ToolDeleteResponse as ToolDeleteResponse,
     type SharedToolResponsesDefaultFlatPagination as SharedToolResponsesDefaultFlatPagination,

package/src/resources/calls/actions.ts

@@ -1546,7 +1546,8 @@ export interface TelnyxVoiceSettings {
 
   /**
    * The voice speed to be used for the voice. The voice speed must be between 0.1
-   * and 2.0. Default value is 1.0.
+   * and 2.0. Default value is 1.0. Not supported for `Telnyx.Bayan.*` or
+   * `Telnyx.Sukhan.*` voices.
    */
   voice_speed?: number;
 }
@@ -1588,7 +1589,11 @@ export interface TranscriptionConfig {
    * controls the language hint), `multi` (no language hint), and language-specific
    * hints `en`, `es`, `fr`, `de`, `hi`, `ru`, `pt`, `ja`, `it`, and `nl`. For
    * `soniox/stt-rt-v4`, `auto` omits the language hint and lets Soniox auto-detect;
-   * ISO 639-1 codes (e.g. `en`, `es`) bias detection toward that language.
+   * ISO 639-1 codes (e.g. `en`, `es`) bias detection toward that language. For
+   * `assemblyai/universal-streaming`, `auto` (or unset) enables native multilingual
+   * code-switching; ISO 639-1 codes (`en`, `es`, `de`, `fr`, `pt`, `it`, `tr`, `nl`,
+   * `sv`, `no`, `da`, `fi`, `hi`, `vi`, `ar`, `he`, `ja`, `zh`) bias the session to
+   * that language.
    */
   language?: string;
 
@@ -1604,7 +1609,7 @@ export interface TranscriptionConfig {
    * - `xai/grok-stt` for live streaming transcription.
    * - `soniox/stt-rt-v4` for live streaming multilingual transcription with
    *   automatic language detection.
-   * - `parakeet/tdt-0.6b-v3` for multilingual transcription with automatic language
+   * - `nvidia/parakeet-v3` for multilingual transcription with automatic language
    *   detection.
    * - `azure/fast` and `azure/realtime`; Azure models require `region`, and
    *   unsupported regions require `api_key_ref`.
@@ -1624,7 +1629,7 @@ export interface TranscriptionConfig {
     | 'assemblyai/universal-streaming'
     | 'xai/grok-stt'
     | 'soniox/stt-rt-v4'
-    | 'parakeet/tdt-0.6b-v3'
+    | 'nvidia/parakeet-v3'
     | 'azure/fast'
     | 'azure/realtime'
     | 'google/latest_long'
@@ -1938,7 +1943,7 @@ export interface TranscriptionEngineParakeetConfig {
   /**
    * The model to use for transcription.
    */
-  transcription_model?: 'parakeet/tdt-0.6b-v3';
+  transcription_model?: 'nvidia/parakeet-v3';
 }
 
 export interface TranscriptionEngineSonioxConfig {
@@ -2420,6 +2425,9 @@ export interface ActionStartAIAssistantParams {
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
    *   `Max`, `TTS2`.
+   * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
+   *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
+   *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    */
@@ -3129,6 +3137,9 @@ export interface ActionGatherUsingAIParams {
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
    *   `Max`, `TTS2`.
+   * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
+   *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
+   *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    */
@@ -3279,6 +3290,9 @@ export interface ActionGatherUsingSpeakParams {
    *   [available voices](https://elevenlabs.io/docs/api-reference/get-voices).
    * - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>` (e.g., `Telnyx.KokoroTTS.af`).
    *   Use `voice_settings` to configure voice_speed and other synthesis parameters.
+   *   `Bayan` provides Arabic (multiple dialects) and English voices (e.g.,
+   *   `Telnyx.Bayan.Ahmed`, `Telnyx.Bayan.Amanda`). `Sukhan` provides Urdu voices
+   *   (e.g., `Telnyx.Sukhan.urdu-professor`); `voice_speed` is not supported.
    * - **Minimax:** Use `Minimax.<ModelId>.<VoiceId>` (e.g.,
    *   `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`
@@ -3293,6 +3307,9 @@ export interface ActionGatherUsingSpeakParams {
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
    *   `Max`, `TTS2`. Use `voice_settings` to configure `delivery_mode` (`STABLE`,
    *   `BALANCED`, `CREATIVE`), supported by `TTS2` only.
+   * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
+   *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
+   *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    *
@@ -4162,6 +4179,9 @@ export interface ActionSpeakParams {
    *   [available voices](https://elevenlabs.io/docs/api-reference/get-voices).
    * - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>` (e.g., `Telnyx.KokoroTTS.af`).
    *   Use `voice_settings` to configure voice_speed and other synthesis parameters.
+   *   `Bayan` provides Arabic (multiple dialects) and English voices (e.g.,
+   *   `Telnyx.Bayan.Ahmed`, `Telnyx.Bayan.Amanda`). `Sukhan` provides Urdu voices
+   *   (e.g., `Telnyx.Sukhan.urdu-professor`); `voice_speed` is not supported.
    * - **Minimax:** Use `Minimax.<ModelId>.<VoiceId>` (e.g.,
    *   `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`
@@ -4176,6 +4196,9 @@ export interface ActionSpeakParams {
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
    *   `Max`, `TTS2`. Use `voice_settings` to configure `delivery_mode` (`STABLE`,
    *   `BALANCED`, `CREATIVE`), supported by `TTS2` only.
+   * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
+   *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
+   *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    *
@@ -5122,6 +5145,9 @@ export interface ActionStartConversationRelayParams {
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
    *   `Max`, `TTS2`.
+   * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
+   *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
+   *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    */

package/src/resources/calls/calls.ts

@@ -525,6 +525,9 @@ export interface ConversationRelayEmbeddedConfig {
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
    *   `Max`, `TTS2`.
+   * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
+   *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
+   *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    */
@@ -1105,6 +1108,15 @@ export interface CallDialParams {
    */
   record_trim?: 'trim-silence';
 
+  /**
+   * Whether to keep trying the remaining routing paths (e.g. alternate
+   * providers/gateways) for the same destination after `timeout_secs` is reached for
+   * the current attempt. When set to `false`, reaching `timeout_secs` aborts the
+   * entire dial attempt and the `call.hangup` webhook reports a `hangup_cause` of
+   * `no_answer` instead of `timeout`.
+   */
+  retry_on_timeout?: boolean;
+
   /**
    * DTMF digits to send automatically after the called party answers. Useful for
    * reaching an extension behind an IVR (e.g. `"200"` to dial extension 200 once the

package/src/resources/conferences/actions.ts

@@ -778,6 +778,9 @@ export interface ActionSpeakParams {
    *   [available voices](https://elevenlabs.io/docs/api-reference/get-voices).
    * - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>` (e.g., `Telnyx.KokoroTTS.af`).
    *   Use `voice_settings` to configure voice_speed and other synthesis parameters.
+   *   `Bayan` provides Arabic (multiple dialects) and English voices (e.g.,
+   *   `Telnyx.Bayan.Ahmed`, `Telnyx.Bayan.Amanda`). `Sukhan` provides Urdu voices
+   *   (e.g., `Telnyx.Sukhan.urdu-professor`); `voice_speed` is not supported.
    * - **Minimax:** Use `Minimax.<ModelId>.<VoiceId>` (e.g.,
    *   `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`
@@ -792,6 +795,9 @@ export interface ActionSpeakParams {
    *   `Inworld.Max.Oliver`, `Inworld.TTS2.Loretta`). Supported models: `Mini`,
    *   `Max`, `TTS2`. Use `voice_settings` to configure `delivery_mode` (`STABLE`,
    *   `BALANCED`, `CREATIVE`), supported by `TTS2` only.
+   * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
+   *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
+   *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    *

package/src/resources/index.ts

@@ -5,11 +5,9 @@ export {
   AI,
   type ModelMetadata,
   type ModelsResponse,
-  type AICreateResponseDeprecatedResponse,
   type AIRetrieveConversationHistoriesResponse,
   type AISummarizeResponse,
   type AISummarizeParams,
-  type AICreateResponseDeprecatedParams,
   type AIRetrieveConversationHistoriesParams,
 } from './ai/ai';
 export {
@@ -593,14 +591,12 @@ export {
   type MessageSendLongCodeResponse,
   type MessageSendNumberPoolResponse,
   type MessageSendShortCodeResponse,
-  type MessageSendWhatsappResponse,
   type MessageSendWithAlphanumericSenderResponse,
   type MessageSendParams,
   type MessageSendLongCodeParams,
   type MessageSendNumberPoolParams,
   type MessageSendShortCodeParams,
   type MessageSendGroupMmsParams,
-  type MessageSendWhatsappParams,
   type MessageScheduleParams,
   type MessageSendWithAlphanumericSenderParams,
 } from './messages/messages';
@@ -1076,6 +1072,7 @@ export {
   type DocReqsRequirement,
   type RequirementRetrieveResponse,
   type RequirementListParams,
+  type RequirementRetrieveParams,
   type DocReqsRequirementsDefaultFlatPagination,
 } from './requirements';
 export {

package/src/resources/managed-accounts/managed-accounts.ts

@@ -374,7 +374,7 @@ export interface ManagedAccountListParams extends DefaultFlatPaginationParams {
   /**
    * Consolidated filter parameter (deepObject style). Originally:
    * filter[email][contains], filter[email][eq], filter[organization_name][contains],
-   * filter[organization_name][eq]
+   * filter[organization_name][eq], filter[status][eq]
    */
   filter?: ManagedAccountListParams.Filter;
 
@@ -406,12 +406,14 @@ export namespace ManagedAccountListParams {
   /**
    * Consolidated filter parameter (deepObject style). Originally:
    * filter[email][contains], filter[email][eq], filter[organization_name][contains],
-   * filter[organization_name][eq]
+   * filter[organization_name][eq], filter[status][eq]
    */
   export interface Filter {
     email?: Filter.Email;
 
     organization_name?: Filter.OrganizationName;
+
+    status?: Filter.Status;
   }
 
   export namespace Filter {
@@ -443,6 +445,15 @@ export namespace ManagedAccountListParams {
        */
       eq?: string;
     }
+
+    export interface Status {
+      /**
+       * If present, only returns managed accounts with the <code>status</code> matching
+       * exactly the value given. Use <code>enabled</code> or <code>disabled</code> to
+       * filter accounts by whether they are currently able to use Telnyx services.
+       */
+      eq?: 'all' | 'active' | 'enabled' | 'cancelled' | 'disabled' | 'blocked';
+    }
   }
 }
 

package/src/resources/messages/index.ts

@@ -23,14 +23,12 @@ export {
   type MessageSendLongCodeResponse,
   type MessageSendNumberPoolResponse,
   type MessageSendShortCodeResponse,
-  type MessageSendWhatsappResponse,
   type MessageSendWithAlphanumericSenderResponse,
   type MessageSendParams,
   type MessageSendLongCodeParams,
   type MessageSendNumberPoolParams,
   type MessageSendShortCodeParams,
   type MessageSendGroupMmsParams,
-  type MessageSendWhatsappParams,
   type MessageScheduleParams,
   type MessageSendWithAlphanumericSenderParams,
 } from './messages';

package/src/resources/messages/messages.ts

@@ -15,6 +15,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Messages
+ */
 export class Messages extends APIResource {
   rcs: RcsAPI.Rcs = new RcsAPI.Rcs(this._client);
 
@@ -110,25 +113,6 @@ export class Messages extends APIResource {
     return this._client.post('/messages/group_mms', { body, ...options });
   }
 
-  /**
-   * Send a Whatsapp message
-   *
-   * @example
-   * ```ts
-   * const response = await client.messages.sendWhatsapp({
-   *   from: '+13125551234',
-   *   to: '+13125551234',
-   *   whatsapp_message: {},
-   * });
-   * ```
-   */
-  sendWhatsapp(
-    body: MessageSendWhatsappParams,
-    options?: RequestOptions,
-  ): APIPromise<MessageSendWhatsappResponse> {
-    return this._client.post('/messages/whatsapp', { body, ...options });
-  }
-
   /**
    * Schedule a message with a Phone Number, Alphanumeric Sender ID, Short Code or
    * Number Pool.
@@ -1560,68 +1544,6 @@ export interface MessageSendShortCodeResponse {
   data?: OutboundMessagePayload;
 }
 
-export interface MessageSendWhatsappResponse {
-  data?: MessageSendWhatsappResponse.Data;
-}
-
-export namespace MessageSendWhatsappResponse {
-  export interface Data {
-    /**
-     * message ID
-     */
-    id?: string;
-
-    body?: MessagesAPI.WhatsappMessageContent;
-
-    direction?: string;
-
-    encoding?: string;
-
-    from?: Data.From;
-
-    messaging_profile_id?: string;
-
-    organization_id?: string;
-
-    received_at?: string;
-
-    record_type?: string;
-
-    to?: Array<MessagesAPI.RcsToItem>;
-
-    type?: string;
-
-    /**
-     * Seconds the message is queued due to rate limiting before being sent to the
-     * carrier. Represents the maximum wait across all applicable rate limits (account,
-     * carrier, campaign). 0.0 = no queuing delay.
-     */
-    wait_seconds?: number | null;
-  }
-
-  export namespace Data {
-    export interface From {
-      /**
-       * The carrier of the sender.
-       */
-      carrier?: string;
-
-      /**
-       * The line-type of the sender.
-       */
-      line_type?: 'Wireline' | 'Wireless' | 'VoWiFi' | 'VoIP' | 'Pre-Paid Wireless' | '';
-
-      /**
-       * Sending address (+E.164 formatted phone number, alphanumeric sender ID, or short
-       * code).
-       */
-      phone_number?: string;
-
-      status?: 'received' | 'delivered';
-    }
-  }
-}
-
 export interface MessageSendWithAlphanumericSenderResponse {
   data?: OutboundMessagePayload;
 }
@@ -1964,35 +1886,6 @@ export interface MessageSendGroupMmsParams {
   webhook_url?: string;
 }
 
-export interface MessageSendWhatsappParams {
-  /**
-   * Phone number in +E.164 format associated with Whatsapp account
-   */
-  from: string;
-
-  /**
-   * Phone number in +E.164 format
-   */
-  to: string;
-
-  whatsapp_message: WhatsappMessageContent;
-
-  /**
-   * Messaging profile ID - required if the 'from' number is not SMS-enabled
-   */
-  messaging_profile_id?: string;
-
-  /**
-   * Message type - must be set to "WHATSAPP"
-   */
-  type?: 'WHATSAPP';
-
-  /**
-   * The URL where webhooks related to this message will be sent.
-   */
-  webhook_url?: string;
-}
-
 export interface MessageScheduleParams {
   /**
    * Receiving address (+E.164 formatted phone number or short code).
@@ -2132,14 +2025,12 @@ export declare namespace Messages {
     type MessageSendLongCodeResponse as MessageSendLongCodeResponse,
     type MessageSendNumberPoolResponse as MessageSendNumberPoolResponse,
     type MessageSendShortCodeResponse as MessageSendShortCodeResponse,
-    type MessageSendWhatsappResponse as MessageSendWhatsappResponse,
     type MessageSendWithAlphanumericSenderResponse as MessageSendWithAlphanumericSenderResponse,
     type MessageSendParams as MessageSendParams,
     type MessageSendLongCodeParams as MessageSendLongCodeParams,
     type MessageSendNumberPoolParams as MessageSendNumberPoolParams,
     type MessageSendShortCodeParams as MessageSendShortCodeParams,
     type MessageSendGroupMmsParams as MessageSendGroupMmsParams,
-    type MessageSendWhatsappParams as MessageSendWhatsappParams,
     type MessageScheduleParams as MessageScheduleParams,
     type MessageSendWithAlphanumericSenderParams as MessageSendWithAlphanumericSenderParams,
   };

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

@@ -264,6 +264,14 @@ export interface PhoneNumberDetailed {
    */
   tags: Array<string>;
 
+  /**
+   * ISO 8601 formatted date indicating when the phone number was first activated
+   * (transitioned from purchase-pending or port-pending to active). Will be null for
+   * numbers that have not yet been activated, or for legacy numbers activated before
+   * this field was tracked.
+   */
+  activated_at?: string | null;
+
   /**
    * Identifies the billing group associated with the phone number.
    */
@@ -384,6 +392,14 @@ export namespace PhoneNumberDeleteResponse {
      */
     id?: string;
 
+    /**
+     * ISO 8601 formatted date indicating when the phone number was first activated
+     * (transitioned from purchase-pending or port-pending to active). Will be null for
+     * numbers that have not yet been activated, or for legacy numbers activated before
+     * this field was tracked.
+     */
+    activated_at?: string | null;
+
     /**
      * Identifies the billing group associated with the phone number.
      */
@@ -530,6 +546,14 @@ export interface PhoneNumberSlimListResponse {
    */
   id?: string;
 
+  /**
+   * ISO 8601 formatted date indicating when the phone number was first activated
+   * (transitioned from purchase-pending or port-pending to active). Will be null for
+   * numbers that have not yet been activated, or for legacy numbers activated before
+   * this field was tracked.
+   */
+  activated_at?: string | null;
+
   /**
    * Identifies the billing group associated with the phone number.
    */

package/src/resources/requirements.ts

@@ -42,8 +42,12 @@ export class Requirements extends APIResource {
    * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<RequirementRetrieveResponse> {
-    return this._client.get(path`/requirements/${id}`, options);
+  retrieve(
+    id: string,
+    query: RequirementRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<RequirementRetrieveResponse> {
+    return this._client.get(path`/requirements/${id}`, { query, ...options });
   }
 }
 
@@ -71,6 +75,17 @@ export interface DocReqsRequirement {
    */
   created_at?: string;
 
+  /**
+   * When this version was superseded. NULL means this is the active or pending
+   * version.
+   */
+  effective_end_at?: string | null;
+
+  /**
+   * When this version became (or will become) active.
+   */
+  effective_start_at?: string | null;
+
   /**
    * The locality where this requirement applies
    */
@@ -90,12 +105,17 @@ export interface DocReqsRequirement {
   /**
    * Lists the requirement types necessary to fulfill this requirement
    */
-  requirements_types?: Array<Shared.DocReqsRequirementType>;
+  requirement_types?: Array<Shared.DocReqsRequirementType>;
 
   /**
    * ISO 8601 formatted date-time indicating when the resource was last updated.
    */
   updated_at?: string;
+
+  /**
+   * Version number. Increments with each new version. Defaults to 1.
+   */
+  version?: number;
 }
 
 export interface RequirementRetrieveResponse {
@@ -123,6 +143,12 @@ export interface RequirementListParams extends DefaultFlatPaginationParams {
     | '-country_code'
     | '-phone_number_type'
   >;
+
+  /**
+   * Filter by requirement version number. When omitted, returns the currently-active
+   * version.
+   */
+  version?: number;
 }
 
 export namespace RequirementListParams {
@@ -149,11 +175,20 @@ export namespace RequirementListParams {
   }
 }
 
+export interface RequirementRetrieveParams {
+  /**
+   * Filter by requirement version number. When omitted, returns the currently-active
+   * version.
+   */
+  version?: number;
+}
+
 export declare namespace Requirements {
   export {
     type DocReqsRequirement as DocReqsRequirement,
     type RequirementRetrieveResponse as RequirementRetrieveResponse,
     type DocReqsRequirementsDefaultFlatPagination as DocReqsRequirementsDefaultFlatPagination,
     type RequirementListParams as RequirementListParams,
+    type RequirementRetrieveParams as RequirementRetrieveParams,
   };
 }

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

@@ -300,7 +300,7 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'xai/grok-stt'
     | 'speechmatics/standard'
     | 'soniox/stt-rt-v4'
-    | 'parakeet/tdt-0.6b-v3';
+    | 'nvidia/parakeet-v3';
 
   /**
    * Enable redaction of sensitive information (e.g., PCI data, SSN) from