telnyx 7.28.0 → 7.29.0

package/src/client.ts

@@ -80,6 +80,7 @@ import {
   AlphanumericSenderIDsDefaultFlatPagination,
   MessagingPaginationMeta0b38e7044b,
 } from './resources/alphanumeric-sender-ids';
+import { ArtifactDownloadRetrieveParams, ArtifactDownloads } from './resources/artifact-downloads';
 import {
   AuditEventListParams,
   AuditEventListResponse,
@@ -572,6 +573,16 @@ import {
   NetworkCoverageListResponse,
   NetworkCoverageListResponsesDefaultFlatPagination,
 } from './resources/network-coverage';
+import {
+  NetappsCursorPaginationMeta,
+  NetworkRoute,
+  NetworkRouteCreateParams,
+  NetworkRouteCreateResponse,
+  NetworkRouteListParams,
+  NetworkRouteListResponse,
+  NetworkRouteRetrieveResponse,
+  NetworkRoutes,
+} from './resources/network-routes';
 import {
   NoiseSuppressionEngineListResponse,
   NoiseSuppressionEngines,
@@ -725,6 +736,16 @@ import {
   TrafficType,
   UsagePaymentMethod,
 } from './resources/outbound-voice-profiles';
+import {
+  GenericPayConnectorConfig,
+  PayConnector,
+  PayConnectorCreateParams,
+  PayConnectorListParams,
+  PayConnectorResponse,
+  PayConnectorUpdateParams,
+  PayConnectors,
+  PayConnectorsEmailBracketCursorPagination,
+} from './resources/pay-connectors';
 import {
   PhoneNumbersRegulatoryRequirementRetrieveParams,
   PhoneNumbersRegulatoryRequirementRetrieveResponse,
@@ -892,6 +913,7 @@ import {
 } from './resources/siprec-connectors';
 import {
   SpendLimit,
+  SpendLimitBlock,
   SpendLimitCreateParams,
   SpendLimitDeleteParams,
   SpendLimitListResponse,
@@ -1289,6 +1311,18 @@ import {
   ModelMetadata,
   ModelsResponse,
 } from './resources/ai/ai';
+import {
+  BrowserSessionCreateParams,
+  BrowserSessionCreateResponse,
+  BrowserSessionDeleteResponse,
+  BrowserSessionListParams,
+  BrowserSessionListResponse,
+  BrowserSessionRetrieveArtifactParams,
+  BrowserSessionRetrieveArtifactResponse,
+  BrowserSessionRetrieveResponse,
+  BrowserSessions,
+  Session,
+} from './resources/browser-sessions/browser-sessions';
 import { BundlePricing } from './resources/bundle-pricing/bundle-pricing';
 import {
   CallAssistantRequest,
@@ -1443,6 +1477,7 @@ import {
   EmailValidationCreateResponse,
   EmailValidations,
 } from './resources/email-validations/email-validations';
+import { Email } from './resources/email/email';
 import {
   BillingContact,
   EnterpriseCreateParams,
@@ -1600,6 +1635,7 @@ import {
   MessagingProfileUpdateParams,
   MessagingProfileUpdateResponse,
   MessagingProfiles,
+  Mm7Metadata,
   NumberPoolSettings,
   URLShortenerSettings,
 } from './resources/messaging-profiles/messaging-profiles';
@@ -1822,6 +1858,16 @@ import {
   TextToSpeechRetrieveSpeechParams,
 } from './resources/text-to-speech/text-to-speech';
 import { TtsIntegrations } from './resources/tts-integrations/tts-integrations';
+import {
+  Tunnel,
+  TunnelCreateParams,
+  TunnelCreateResponse,
+  TunnelListParams,
+  TunnelListResponse,
+  TunnelRetrieveResponse,
+  TunnelWithToken,
+  Tunnels,
+} from './resources/tunnels/tunnels';
 import {
   UacConnection,
   UacConnectionCreateParams,
@@ -2726,6 +2772,7 @@ export class Telnyx {
 
   static toFile = Uploads.toFile;
 
+  browserSessions: API.BrowserSessions = new API.BrowserSessions(this);
   legacy: API.Legacy = new API.Legacy(this);
   oauth: API.OAuth = new API.OAuth(this);
   oauthClients: API.OAuthClients = new API.OAuthClients(this);
@@ -3353,6 +3400,7 @@ export class Telnyx {
    * - **Blocking.** When spend in a period goes above the limit (strictly greater), the product is blocked until the period ends: 00:00 UTC the next day for `daily`, 00:00 UTC on the 1st of the next month for `monthly`. A block appears within about 2 minutes (daily) or 10 minutes (monthly) of the spend being recorded.
    * - **Changes apply immediately.** Creating, updating or deleting a limit checks the period's spend in the same request: raising the limit above the spend, or removing it, lifts that period's block, and lowering it below the spend blocks the product at once. The `evaluation` object in the response says what happened.
    * - **Supported products.** Today only `inference` supports spend limits. A blocked account gets HTTP 403 with the error title `Inference spend limit reached` (code `10039`) on new billable chat completions, Responses, Anthropic Messages and classification requests; requests already running finish normally. Take the list of products from the list operation.
+   * - **API key limits.** For `inference`, a limit can also apply to one API key, named by `credential_id`: the key's identifier as recorded on usage, never its secret. When the key's spend goes above its own limit, only that key is blocked, with the error title `API key spend limit reached` (code `10039`); the account's other keys keep working. The API key limits of a period cannot add up to more than the total limit when the total has an amount. Only language-model requests authenticated with an API key count toward its limit.
    * - **Limits set by Telnyx.** Telnyx support can also set a limit on your account. It is listed with `origin: operator` and you can update or delete it like your own.
    */
   spendLimits: API.SpendLimits = new API.SpendLimits(this);
@@ -3370,8 +3418,26 @@ export class Telnyx {
    * Tailscale Subnet Router operations
    */
   tailscaleSubnetRouters: API.TailscaleSubnetRouters = new API.TailscaleSubnetRouters(this);
+  /**
+   * Download screenshots and other artifacts.
+   */
+  artifactDownloads: API.ArtifactDownloads = new API.ArtifactDownloads(this);
+  email: API.Email = new API.Email(this);
+  /**
+   * Routes on a Network that send a CIDR to a next hop, such as a tunnel.
+   */
+  networkRoutes: API.NetworkRoutes = new API.NetworkRoutes(this);
+  /**
+   * Generic payment connector configuration.
+   */
+  payConnectors: API.PayConnectors = new API.PayConnectors(this);
+  /**
+   * Tunnels connect a Network to hosts behind a tunnel process within the user's network.
+   */
+  tunnels: API.Tunnels = new API.Tunnels(this);
 }
 
+Telnyx.BrowserSessions = BrowserSessions;
 Telnyx.Legacy = Legacy;
 Telnyx.OAuth = OAuth;
 Telnyx.OAuthClients = OAuthClients;
@@ -3566,6 +3632,11 @@ Telnyx.SipRegistrationStatus = SipRegistrationStatus;
 Telnyx.DialMetrics = DialMetrics;
 Telnyx.TtsIntegrations = TtsIntegrations;
 Telnyx.TailscaleSubnetRouters = TailscaleSubnetRouters;
+Telnyx.ArtifactDownloads = ArtifactDownloads;
+Telnyx.Email = Email;
+Telnyx.NetworkRoutes = NetworkRoutes;
+Telnyx.PayConnectors = PayConnectors;
+Telnyx.Tunnels = Tunnels;
 
 export declare namespace Telnyx {
   export type RequestOptions = Opts.RequestOptions;
@@ -3642,6 +3713,19 @@ export declare namespace Telnyx {
     type CloudfsCursorPaginationResponse as CloudfsCursorPaginationResponse,
   };
 
+  export {
+    BrowserSessions as BrowserSessions,
+    type Session as Session,
+    type BrowserSessionCreateResponse as BrowserSessionCreateResponse,
+    type BrowserSessionRetrieveResponse as BrowserSessionRetrieveResponse,
+    type BrowserSessionListResponse as BrowserSessionListResponse,
+    type BrowserSessionDeleteResponse as BrowserSessionDeleteResponse,
+    type BrowserSessionRetrieveArtifactResponse as BrowserSessionRetrieveArtifactResponse,
+    type BrowserSessionRetrieveArtifactParams as BrowserSessionRetrieveArtifactParams,
+    type BrowserSessionListParams as BrowserSessionListParams,
+    type BrowserSessionCreateParams as BrowserSessionCreateParams,
+  };
+
   export { Legacy as Legacy };
 
   export {
@@ -4485,6 +4569,7 @@ export declare namespace Telnyx {
     type MessagingMessagingProfile as MessagingMessagingProfile,
     type MessagingProfile as MessagingProfile,
     type MessagingProfileFeatures as MessagingProfileFeatures,
+    type Mm7Metadata as Mm7Metadata,
     type NumberPoolSettings as NumberPoolSettings,
     type URLShortenerSettings as URLShortenerSettings,
     type MessagingProfileCreateResponse as MessagingProfileCreateResponse,
@@ -5651,6 +5736,7 @@ export declare namespace Telnyx {
   export {
     SpendLimits as SpendLimits,
     type SpendLimit as SpendLimit,
+    type SpendLimitBlock as SpendLimitBlock,
     type SpendLimitPeriod as SpendLimitPeriod,
     type SpendLimitResponse as SpendLimitResponse,
     type SpendLimitListResponse as SpendLimitListResponse,
@@ -5689,6 +5775,46 @@ export declare namespace Telnyx {
     type TailscaleSubnetRouterUpdateParams as TailscaleSubnetRouterUpdateParams,
   };
 
+  export {
+    ArtifactDownloads as ArtifactDownloads,
+    type ArtifactDownloadRetrieveParams as ArtifactDownloadRetrieveParams,
+  };
+
+  export { Email as Email };
+
+  export {
+    NetworkRoutes as NetworkRoutes,
+    type NetappsCursorPaginationMeta as NetappsCursorPaginationMeta,
+    type NetworkRoute as NetworkRoute,
+    type NetworkRouteCreateResponse as NetworkRouteCreateResponse,
+    type NetworkRouteRetrieveResponse as NetworkRouteRetrieveResponse,
+    type NetworkRouteListResponse as NetworkRouteListResponse,
+    type NetworkRouteListParams as NetworkRouteListParams,
+    type NetworkRouteCreateParams as NetworkRouteCreateParams,
+  };
+
+  export {
+    PayConnectors as PayConnectors,
+    type GenericPayConnectorConfig as GenericPayConnectorConfig,
+    type PayConnector as PayConnector,
+    type PayConnectorResponse as PayConnectorResponse,
+    type PayConnectorsEmailBracketCursorPagination as PayConnectorsEmailBracketCursorPagination,
+    type PayConnectorListParams as PayConnectorListParams,
+    type PayConnectorCreateParams as PayConnectorCreateParams,
+    type PayConnectorUpdateParams as PayConnectorUpdateParams,
+  };
+
+  export {
+    Tunnels as Tunnels,
+    type Tunnel as Tunnel,
+    type TunnelWithToken as TunnelWithToken,
+    type TunnelCreateResponse as TunnelCreateResponse,
+    type TunnelRetrieveResponse as TunnelRetrieveResponse,
+    type TunnelListResponse as TunnelListResponse,
+    type TunnelListParams as TunnelListParams,
+    type TunnelCreateParams as TunnelCreateParams,
+  };
+
   export type APIError = API.APIError;
   export type AvailablePhoneNumbersMetadata = API.AvailablePhoneNumbersMetadata;
   export type AzureVoiceSettings = API.AzureVoiceSettings;

package/src/resources/addresses/actions.ts

@@ -78,10 +78,7 @@ export interface ActionValidateResponse {
 
 export namespace ActionValidateResponse {
   export interface Data {
-    /**
-     * Indicates whether an address is valid or invalid.
-     */
-    result: 'valid' | 'invalid';
+    result: 'valid';
 
     /**
      * Provides normalized address when available.
@@ -107,6 +104,12 @@ export namespace ActionValidateResponse {
        */
       administrative_area?: string;
 
+      /**
+       * The borough of the address. This field is not used for addresses in the US but
+       * is used for some international addresses.
+       */
+      borough?: string;
+
       /**
        * The two-character (ISO 3166-1 alpha-2) country code of the address.
        */
@@ -118,12 +121,28 @@ export namespace ActionValidateResponse {
        */
       extended_address?: string;
 
+      /**
+       * Latitude of the suggested address, when available.
+       */
+      latitude?: number | null;
+
       /**
        * The locality of the address. For US addresses, this corresponds to the city of
        * the address.
        */
       locality?: string;
 
+      /**
+       * Longitude of the suggested address, when available.
+       */
+      longitude?: number | null;
+
+      /**
+       * The neighborhood of the address. This field is not used for addresses in the US
+       * but is used for some international addresses.
+       */
+      neighborhood?: string;
+
       /**
        * The postal code of the address.
        */

package/src/resources/ai/ai.ts

@@ -193,6 +193,8 @@ import {
 } from './missions/missions';
 import * as OpenAIAPI from './openai/openai';
 import { OpenAI, OpenAICreateResponseParams, OpenAICreateResponseResponse } from './openai/openai';
+import * as TestsAPI from './tests/tests';
+import { Tests } from './tests/tests';
 import * as TypesafeAPI from './typesafe/typesafe';
 import { Typesafe } from './typesafe/typesafe';
 import { APIPromise } from '../../core/api-promise';
@@ -219,6 +221,7 @@ export class AI extends APIResource {
   typesafe: TypesafeAPI.Typesafe = new TypesafeAPI.Typesafe(this._client);
   memory: MemoryAPI.Memory = new MemoryAPI.Memory(this._client);
   avatars: AvatarsAPI.Avatars = new AvatarsAPI.Avatars(this._client);
+  tests: TestsAPI.Tests = new TestsAPI.Tests(this._client);
 
   /**
    * Generate a summary of a file's contents.
@@ -674,6 +677,7 @@ AI.Knowledge = Knowledge;
 AI.Typesafe = Typesafe;
 AI.Memory = Memory;
 AI.Avatars = Avatars;
+AI.Tests = Tests;
 
 export declare namespace AI {
   export {
@@ -887,4 +891,6 @@ export declare namespace AI {
     type AvatarCreateParams as AvatarCreateParams,
     type AvatarUpdateParams as AvatarUpdateParams,
   };
+
+  export { Tests as Tests };
 }

package/src/resources/ai/assistants/assistants.ts

@@ -3804,9 +3804,10 @@ export interface TranscriptionSettings {
    *   auto-detect; set `language` from Speechmatics' Realtime language list
    *   (defaults to `en`).
    * - `azure/fast` is a multilingual Azure transcription model.
-   * - `assemblyai/universal-3-5-pro` is a multilingual streaming model with
-   *   configurable turn detection. The legacy alias `assemblyai/universal-streaming`
-   *   is still accepted and resolves to the same model.
+   * - `assemblyai/universal-3-6-pro` (AssemblyAI Universal-3.6 Pro) is a
+   *   multilingual streaming model with configurable turn detection. The legacy
+   *   aliases `assemblyai/universal-3-5-pro` and `assemblyai/universal-streaming`
+   *   are still accepted and run the same model.
    * - `xai/grok-stt` is a multilingual Grok STT model.
    * - `soniox/stt-rt-v4` and `soniox/stt-rt-v5` are multilingual streaming models
    *   with automatic language detection, configurable endpointing, term biasing
@@ -3829,6 +3830,7 @@ export interface TranscriptionSettings {
     | 'speechmatics/standard'
     | 'speechmatics/linden-1'
     | 'azure/fast'
+    | 'assemblyai/universal-3-6-pro'
     | 'assemblyai/universal-3-5-pro'
     | 'assemblyai/universal-streaming'
     | 'xai/grok-stt'
@@ -3861,11 +3863,11 @@ export namespace TranscriptionSettings {
     /**
      * The language booster's model. It must be the same kind of model as
      * `transcription.model`: both streaming (`deepgram/flux`, `deepgram/nova-3`,
-     * `deepgram/nova-2`, `assemblyai/universal-3-5-pro` or its legacy alias
-     * `assemblyai/universal-streaming`, `xai/grok-stt`, `soniox/stt-rt-v4`,
-     * `soniox/stt-rt-v5`, `humain/realtime`, `reson8/turns`) or both non-streaming
-     * (`azure/fast`, `nvidia/parakeet-v3`, `omi-health/omi-med-stt-v1`,
-     * `cohere/ar-stt`, `distil-whisper/distil-large-v2`,
+     * `deepgram/nova-2`, `assemblyai/universal-3-6-pro` or its legacy aliases
+     * `assemblyai/universal-3-5-pro` and `assemblyai/universal-streaming`,
+     * `xai/grok-stt`, `soniox/stt-rt-v4`, `soniox/stt-rt-v5`, `humain/realtime`,
+     * `reson8/turns`) or both non-streaming (`azure/fast`, `nvidia/parakeet-v3`,
+     * `omi-health/omi-med-stt-v1`, `cohere/ar-stt`, `distil-whisper/distil-large-v2`,
      * `openai/whisper-large-v3-turbo`, `telnyx/basira`). It can be the same model as
      * `transcription.model` on a different `language`.
      */
@@ -3874,6 +3876,7 @@ export namespace TranscriptionSettings {
       | 'deepgram/nova-3'
       | 'deepgram/nova-2'
       | 'azure/fast'
+      | 'assemblyai/universal-3-6-pro'
       | 'assemblyai/universal-3-5-pro'
       | 'assemblyai/universal-streaming'
       | 'xai/grok-stt'
@@ -3936,14 +3939,16 @@ export namespace TranscriptionSettings {
     /**
      * The fallback model. It must be a streaming model other than
      * `transcription.model` and the other fallbacks: `deepgram/flux`,
-     * `deepgram/nova-3`, `deepgram/nova-2`, `assemblyai/universal-3-5-pro` (or its
-     * legacy alias `assemblyai/universal-streaming`), `xai/grok-stt`,
-     * `soniox/stt-rt-v4`, `soniox/stt-rt-v5`, `humain/realtime`, or `reson8/turns`.
+     * `deepgram/nova-3`, `deepgram/nova-2`, `assemblyai/universal-3-6-pro` (or its
+     * legacy aliases `assemblyai/universal-3-5-pro` and
+     * `assemblyai/universal-streaming`), `xai/grok-stt`, `soniox/stt-rt-v4`,
+     * `soniox/stt-rt-v5`, `humain/realtime`, or `reson8/turns`.
      */
     model:
       | 'deepgram/flux'
       | 'deepgram/nova-3'
       | 'deepgram/nova-2'
+      | 'assemblyai/universal-3-6-pro'
       | 'assemblyai/universal-3-5-pro'
       | 'assemblyai/universal-streaming'
       | 'xai/grok-stt'
@@ -4026,9 +4031,9 @@ export interface TranscriptionSettingsConfig {
    * transcription, used by Deepgram, Reson8, Speechmatics Linden 1 and AssemblyAI
    * models. Helps improve accuracy for domain-specific terminology, proper nouns, or
    * uncommon words. At most 1000 characters in total. For
-   * assemblyai/universal-3-5-pro (and its legacy alias
-   * assemblyai/universal-streaming), also at most 100 terms of up to 50 characters
-   * each. This field may be templated with
+   * assemblyai/universal-3-6-pro (and its legacy aliases
+   * assemblyai/universal-3-5-pro and assemblyai/universal-streaming), also at most
+   * 100 terms of up to 50 characters each. This field may be templated with
    * [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
    * using mustache syntax (e.g. `Telnyx,{{customer_name}},VoIP`). Variables are
    * resolved at call time before the value is sent to the speech-to-text engine.
@@ -4050,26 +4055,28 @@ export interface TranscriptionSettingsConfig {
   max_endpoint_delay_ms?: number;
 
   /**
-   * Available only for assemblyai/universal-3-5-pro (and its legacy alias
-   * assemblyai/universal-streaming). Maximum duration of silence in milliseconds
-   * before forcing an end of turn.
+   * Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+   * assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Maximum
+   * duration of silence in milliseconds before forcing an end of turn.
    */
   max_turn_silence?: number;
 
   /**
-   * Available only for assemblyai/universal-3-5-pro (and its legacy alias
-   * assemblyai/universal-streaming). Minimum duration of silence in milliseconds
-   * before a turn can end. Must be less than or equal to max_turn_silence.
+   * Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+   * assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Minimum
+   * duration of silence in milliseconds before a turn can end. Must be less than or
+   * equal to max_turn_silence.
    */
   min_turn_silence?: number;
 
   numerals?: boolean;
 
   /**
-   * Available only for assemblyai/universal-3-5-pro (and its legacy alias
-   * assemblyai/universal-streaming). Context about the conversation (domain, names,
-   * terms) to improve transcription; describe the content, do not give instructions.
-   * Leave empty unless needed. At most 1750 characters.
+   * Available only for assemblyai/universal-3-6-pro (and its legacy aliases
+   * assemblyai/universal-3-5-pro and assemblyai/universal-streaming). Context about
+   * the conversation (domain, names, terms) to improve transcription; describe the
+   * content, do not give instructions. Leave empty unless needed. At most 1750
+   * characters.
    */
   prompt?: string;
 

package/src/resources/ai/avatars.ts

@@ -44,15 +44,15 @@ export class Avatars extends APIResource {
    * is stored independently from the rendering model and background, which are
    * selected where the avatar is consumed. Supported image types are JPEG, PNG, and
    * WebP. Images may be up to 10 MiB, must be between 256 and 8192 pixels on each
-   * side, and may contain at most 40 megapixels. Each organization may have up to 20
-   * custom avatars. For best results, use a 16:9 landscape image, preferably 1920 by
-   * 1080 pixels and at least 1280 by 720 pixels. Show one centered, front-facing
-   * person from the shoulders up, keep the full head and hair visible with space
-   * around it, and use a sharp, evenly lit image with unobstructed eyes and mouth.
-   * Use a transparent PNG or WebP when the avatar will be combined with a selectable
-   * background. These composition recommendations are not enforced in the first
-   * release; the first release does not validate the number of faces, pose, or image
-   * content.
+   * side, and may contain at most 40 megapixels. A per-organization custom-avatar
+   * quota applies; the create request returns an error when the quota is reached.
+   * For best results, use a 16:9 landscape image, preferably 1920 by 1080 pixels and
+   * at least 1280 by 720 pixels. Show one centered, front-facing person from the
+   * shoulders up, keep the full head and hair visible with space around it, and use
+   * a sharp, evenly lit image with unobstructed eyes and mouth. Use a transparent
+   * PNG or WebP when the avatar will be combined with a selectable background. These
+   * composition recommendations are not enforced in the first release; the first
+   * release does not validate the number of faces, pose, or image content.
    *
    * @example
    * ```ts

package/src/resources/ai/index.ts

@@ -174,6 +174,7 @@ export {
   type MissionDataDefaultFlatPagination,
 } from './missions/index';
 export { OpenAI, type OpenAICreateResponseResponse, type OpenAICreateResponseParams } from './openai/index';
+export { Tests } from './tests/index';
 export {
   Tools,
   type PayToolParams,

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

@@ -0,0 +1,5 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Schedules } from './schedules/index';
+export { TestFramework } from './test-framework/index';
+export { Tests } from './tests';

package/src/resources/ai/tests/schedules/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Schedules } from './schedules';
+export { V1 } from './v1/index';

package/src/resources/ai/tests/schedules/schedules.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import * as V1API from './v1/v1';
+import { V1 } from './v1/v1';
+
+export class Schedules extends APIResource {
+  v1: V1API.V1 = new V1API.V1(this._client);
+}
+
+Schedules.V1 = V1;
+
+export declare namespace Schedules {
+  export { V1 as V1 };
+}