telnyx 7.12.0 → 7.13.0

package/src/resources/index.ts

@@ -325,6 +325,106 @@ export {
   type DynamicEmergencyEndpointCreateParams,
   type DynamicEmergencyEndpointsDefaultFlatPagination,
 } from './dynamic-emergency-endpoints';
+export {
+  EmailBlocks,
+  type EmailBlock,
+  type EmailBlockResponse,
+  type OffsetMeta,
+  type EmailBlockRetrieveEventsResponse,
+  type EmailBlockRetrieveExportResponse,
+  type EmailBlockListParams,
+  type EmailBlockCreateParams,
+  type EmailBlockRetrieveExportParams,
+  type EmailBlockRetrieveEventsParams,
+  type EmailBlocksDefaultFlatPagination,
+} from './email-blocks/email-blocks';
+export {
+  EmailDomains,
+  type DNSRecord,
+  type DomainsTrackingSettings,
+  type EmailDmarcPolicy,
+  type EmailDomain,
+  type EmailDomainResponse,
+  type EmailDomainStatus,
+  type EmailDomainType,
+  type EmailDomainVerification,
+  type EmailDomainRetrieveDNSRecordsResponse,
+  type EmailDomainRetrieveHealthResponse,
+  type EmailDomainListParams,
+  type EmailDomainCreateParams,
+  type EmailDomainDeleteParams,
+  type EmailDomainUpdateParams,
+  type EmailDomainsDefaultFlatPagination,
+} from './email-domains/email-domains';
+export {
+  EmailEvents,
+  type EmailEventType,
+  type TimeRange,
+  type EmailEventListResponse,
+  type EmailEventRetrieveStatsResponse,
+  type EmailEventListParams,
+  type EmailEventRetrieveStatsParams,
+} from './email-events';
+export {
+  EmailInboxes,
+  type EmailInbox,
+  type EmailInboxResponse,
+  type EmailInboxListResponse,
+  type EmailInboxListParams,
+  type EmailInboxCreateParams,
+} from './email-inboxes/email-inboxes';
+export {
+  EmailMessages,
+  type AttachmentRequest,
+  type EmailAddressInput,
+  type MessageEvent,
+  type TrackingSettings,
+  type EmailMessageRetrieveResponse,
+  type EmailMessageListResponse,
+  type EmailMessageBatchResponse,
+  type EmailMessageRetrieveEventsResponse,
+  type EmailMessageDeleteAllParams,
+  type EmailMessageListParams,
+  type EmailMessageCreateParams,
+  type EmailMessageBatchParams,
+  type EmailMessageRetrieveEventsParams,
+} from './email-messages/email-messages';
+export {
+  EmailTemplates,
+  type EmailTemplate,
+  type EmailTemplateResponse,
+  type UpdateEmailTemplateRequest,
+  type EmailTemplateListResponse,
+  type EmailTemplateRenderResponse,
+  type EmailTemplateListParams,
+  type EmailTemplateCreateParams,
+  type EmailTemplateReplaceParams,
+  type EmailTemplateUpdateParams,
+  type EmailTemplateRenderParams,
+} from './email-templates';
+export {
+  EmailThreads,
+  type EmailThreadRetrieveResponse,
+  type EmailThreadListParams,
+  type EmailThreadRetrieveParams,
+} from './email-threads';
+export {
+  EmailUnsubscribeGroups,
+  type GroupListMeta,
+  type UnsubscribeGroup,
+  type UnsubscribeGroupResponse,
+  type EmailUnsubscribeGroupListParams,
+  type EmailUnsubscribeGroupCreateParams,
+  type EmailUnsubscribeGroupDeleteParams,
+  type EmailUnsubscribeGroupUpdateParams,
+  type UnsubscribeGroupsDefaultFlatPagination,
+} from './email-unsubscribe-groups/email-unsubscribe-groups';
+export {
+  EmailValidations,
+  type EmailValidationCheck,
+  type EmailValidationCreateResponse,
+  type EmailValidationCreateParams,
+} from './email-validations/email-validations';
 export {
   Enterprises,
   type BillingAddress,
@@ -968,6 +1068,7 @@ export {
   type PortoutUpdateStatusParams,
   type PortoutDetailsDefaultFlatPagination,
 } from './portouts/portouts';
+export { Pricing } from './pricing/pricing';
 export {
   PrivateWirelessGateways,
   type PrivateWirelessGateway,
@@ -1513,6 +1614,8 @@ export {
   type CallMachineGreetingEndedWebhookEvent,
   type CallMachinePremiumDetectionEndedWebhookEvent,
   type CallMachinePremiumGreetingEndedWebhookEvent,
+  type CallPaymentCompletedWebhookEvent,
+  type CallPaymentProgressWebhookEvent,
   type CallPlaybackEndedWebhookEvent,
   type CallPlaybackStartedWebhookEvent,
   type CallRecordingErrorWebhookEvent,

package/src/resources/pricing/index.ts

@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Pricing } from './pricing';
+export {
+  Products,
+  type PricingPaginationMeta,
+  type PricingTier,
+  type ProductRetrieveResponse,
+  type ProductListResponse,
+  type ProductListParams,
+  type ProductRetrieveParams,
+  type ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders,
+} from './products';

package/src/resources/pricing/pricing.ts

@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ProductsAPI from './products';
+import {
+  PricingPaginationMeta,
+  PricingTier,
+  ProductListParams,
+  ProductListResponse,
+  ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders,
+  ProductRetrieveParams,
+  ProductRetrieveResponse,
+  Products,
+} from './products';
+
+export class Pricing extends APIResource {
+  products: ProductsAPI.Products = new ProductsAPI.Products(this._client);
+}
+
+Pricing.Products = Products;
+
+export declare namespace Pricing {
+  export {
+    Products as Products,
+    type PricingPaginationMeta as PricingPaginationMeta,
+    type PricingTier as PricingTier,
+    type ProductRetrieveResponse as ProductRetrieveResponse,
+    type ProductListResponse as ProductListResponse,
+    type ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders as ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders,
+    type ProductListParams as ProductListParams,
+    type ProductRetrieveParams as ProductRetrieveParams,
+  };
+}

package/src/resources/pricing/products.ts

@@ -0,0 +1,226 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ProductsAPI from './products';
+import { APIPromise } from '../../core/api-promise';
+import {
+  DefaultFlatPaginationForInexplicitNumberOrders,
+  type DefaultFlatPaginationForInexplicitNumberOrdersParams,
+  PagePromise,
+} from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Public pricing operations
+ */
+export class Products extends APIResource {
+  /**
+   * Returns the full product catalog with pagination. Each entry contains a slug,
+   * display name, and description. Use the slug to fetch per-product pricing via GET
+   * /pricing/products/{slug}.
+   */
+  list(
+    query: ProductListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders, ProductListResponse> {
+    return this._client.getAPIList(
+      '/pricing/products',
+      DefaultFlatPaginationForInexplicitNumberOrders<ProductListResponse>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Returns pricing entries for a single product. Most products return standard rate
+   * entries with fields like rate, unit, country_iso, direction, and tiers.
+   * Inference products return model-specific fields (model, input_rate, output_rate,
+   * cached_input_rate) with tiered pricing. Some products use rate decks
+   * (pricing_type: rate_deck) where rates are determined dynamically.
+   */
+  retrieve(
+    slug: string,
+    query: ProductRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ProductRetrieveResponse> {
+    return this._client.get(path`/pricing/products/${slug}`, { query, ...options });
+  }
+}
+
+export type ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders =
+  DefaultFlatPaginationForInexplicitNumberOrders<ProductListResponse>;
+
+export interface PricingPaginationMeta {
+  page_number: number;
+
+  page_size: number;
+
+  total_pages: number;
+
+  total_results: number;
+}
+
+export interface PricingTier {
+  /**
+   * Upper bound of the tier (exclusive). Null means no upper limit.
+   */
+  max: number | null;
+
+  /**
+   * Lower bound of the tier (inclusive).
+   */
+  min: number;
+
+  /**
+   * Rate for this tier. Numeric for standard products, string for inference
+   * products.
+   */
+  rate: number | string;
+}
+
+export interface ProductRetrieveResponse {
+  data: Array<ProductRetrieveResponse.Data>;
+
+  meta: PricingPaginationMeta;
+}
+
+export namespace ProductRetrieveResponse {
+  /**
+   * A single pricing entry. Standard products include rate, unit, currency, type,
+   * country_iso, direction, and tiers. Inference products include model, input_rate,
+   * output_rate, cached_input_rate, and their respective tier arrays. Rate-deck
+   * products include pricing_type and note fields with null rate and empty tiers.
+   */
+  export interface Data {
+    /**
+     * Cached input token rate. Present only on inference product entries.
+     */
+    cached_input_rate?: string;
+
+    /**
+     * Cached input token tiered pricing. Present only on inference product entries.
+     */
+    cached_input_tiers?: Array<ProductsAPI.PricingTier>;
+
+    /**
+     * ISO country code. Null for non-geographic products.
+     */
+    country_iso?: string | null;
+
+    /**
+     * ISO currency code (e.g., USD).
+     */
+    currency?: string;
+
+    /**
+     * Direction (e.g., termination). Null for non-directional products.
+     */
+    direction?: string | null;
+
+    /**
+     * Input token rate. Present only on inference product entries.
+     */
+    input_rate?: string;
+
+    /**
+     * Input token tiered pricing. Present only on inference product entries.
+     */
+    input_tiers?: Array<ProductsAPI.PricingTier>;
+
+    /**
+     * Model identifier. Present only on inference product entries.
+     */
+    model?: string;
+
+    /**
+     * Human-readable name describing the pricing entry.
+     */
+    name?: string;
+
+    /**
+     * Additional note for rate-deck products (e.g., "Pricing is determined by the
+     * WhatsApp rate deck.").
+     */
+    note?: string | null;
+
+    /**
+     * Output token rate. Present only on inference product entries.
+     */
+    output_rate?: string;
+
+    /**
+     * Output token tiered pricing. Present only on inference product entries.
+     */
+    output_tiers?: Array<ProductsAPI.PricingTier>;
+
+    /**
+     * Pricing type for non-standard products (e.g., rate_deck). Absent on standard
+     * products.
+     */
+    pricing_type?: string | null;
+
+    /**
+     * Per-unit rate. Numeric for standard products, string for inference products.
+     * Null for rate-deck products.
+     */
+    rate?: number | string | null;
+
+    /**
+     * Volume-based tiered pricing. Empty for rate-deck products.
+     */
+    tiers?: Array<ProductsAPI.PricingTier>;
+
+    /**
+     * Pricing type (e.g., usage).
+     */
+    type?: string;
+
+    /**
+     * Unit of measurement (e.g., part, message, GB, per_1k_tokens).
+     */
+    unit?: string;
+  }
+}
+
+export interface ProductListResponse {
+  /**
+   * Human-readable description of the product.
+   */
+  description: string;
+
+  /**
+   * Display name of the product.
+   */
+  name: string;
+
+  /**
+   * Product identifier used in the per-product pricing endpoint.
+   */
+  slug: string;
+}
+
+export interface ProductListParams extends DefaultFlatPaginationForInexplicitNumberOrdersParams {}
+
+export interface ProductRetrieveParams {
+  /**
+   * Page number (1-based).
+   */
+  page_number?: number;
+
+  /**
+   * Number of items per page (max 100).
+   */
+  page_size?: number;
+}
+
+export declare namespace Products {
+  export {
+    type PricingPaginationMeta as PricingPaginationMeta,
+    type PricingTier as PricingTier,
+    type ProductRetrieveResponse as ProductRetrieveResponse,
+    type ProductListResponse as ProductListResponse,
+    type ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders as ProductListResponsesDefaultFlatPaginationForInexplicitNumberOrders,
+    type ProductListParams as ProductListParams,
+    type ProductRetrieveParams as ProductRetrieveParams,
+  };
+}

package/src/resources/pricing.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './pricing/index';

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

@@ -43,7 +43,7 @@ export class SpeechToText extends APIResource {
    * `Authorization: Bearer <API_KEY>` header.
    *
    * Supported engines: `Azure`, `Deepgram`, `Google`, `Telnyx`, `xAI`,
-   * `Speechmatics`, `Soniox`, `Parakeet`, `Humain`.
+   * `Speechmatics`, `Soniox`, `Parakeet`, `Humain`, `Reson8`.
    *
    * **Connection flow:**
    *
@@ -215,6 +215,7 @@ export interface SpeechToTextListProvidersParams {
     | 'soniox'
     | 'parakeet'
     | 'humain'
+    | 'reson8'
     | 'azure'
     | 'openai'
     | 'google'
@@ -249,7 +250,8 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'Speechmatics'
     | 'Soniox'
     | 'Parakeet'
-    | 'Humain';
+    | 'Humain'
+    | 'Reson8';
 
   /**
    * Silence duration (in milliseconds) that triggers end-of-speech detection. When
@@ -303,7 +305,8 @@ export interface SpeechToTextRetrieveTranscriptionParams {
     | 'speechmatics/standard'
     | 'soniox/stt-rt-v4'
     | 'nvidia/parakeet-v3'
-    | 'humain/realtime';
+    | 'humain/realtime'
+    | 'reson8/turns';
 
   /**
    * Enable redaction of sensitive information (e.g., PCI data, SSN) from

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

@@ -364,6 +364,12 @@ export interface UacExternalSettings {
    */
   transport?: 'UDP' | 'TLS' | 'TCP' | null;
 
+  /**
+   * Custom SIP User-Agent header value that Telnyx uses on outbound REGISTER and
+   * INVITE messages. Set to null to use Telnyx's default User-Agent.
+   */
+  user_agent?: string | null;
+
   /**
    * The SIP username used to authenticate with the external SIP peer for
    * registrations and outbound calls. Must start with a letter or number and contain