telnyx 7.20.0 → 7.21.0

package/src/resources/ai/openai/chat.ts

@@ -115,6 +115,15 @@ export interface ChatCreateCompletionParams {
    */
   min_p?: number;
 
+  /**
+   * How strictly `region` is applied. `preferred` (the default when `region` is set)
+   * tries that region first and falls back to another when the model cannot be
+   * served there, so a request that would have succeeded still succeeds. `strict`
+   * pins the request: it is served from that region or it fails with a 422, never
+   * redirected to another region. Requires `region`.
+   */
+  mode?: 'preferred' | 'strict';
+
   /**
    * The language model to chat with.
    */
@@ -139,6 +148,15 @@ export interface ChatCreateCompletionParams {
    */
   reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 
+  /**
+   * Optional data-residency region the request should be served from, using the same
+   * vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+   * Supported for Telnyx-hosted models only: a request routed to an external
+   * provider never passes through Telnyx model routing, so a region cannot be
+   * enforced for it. Omit for today's latency-based routing.
+   */
+  region?: 'USA' | 'EU' | 'AUS' | 'UAE';
+
   /**
    * Use this is you want to guarantee a JSON output without defining a schema. For
    * control over the schema, use `guided_json`.

package/src/resources/ai/openai/openai.ts

@@ -121,6 +121,15 @@ export interface OpenAICreateResponseParams {
    */
   instructions?: string;
 
+  /**
+   * How strictly `region` is applied. `preferred` (the default when `region` is set)
+   * tries that region first and falls back to another when the model cannot be
+   * served there, so a request that would have succeeded still succeeds. `strict`
+   * pins the request: it is served from that region or it fails with a 422, never
+   * redirected to another region. Requires `region`.
+   */
+  mode?: 'preferred' | 'strict';
+
   /**
    * Model identifier to use for the response, for example `zai-org/GLM-5.1-FP8` or
    * another model available from the Telnyx OpenAI-compatible models endpoint.
@@ -129,6 +138,15 @@ export interface OpenAICreateResponseParams {
 
   reasoning?: OpenAICreateResponseParams.Reasoning;
 
+  /**
+   * Optional data-residency region the request should be served from, using the same
+   * vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+   * Supported for Telnyx-hosted models only: a request routed to an external
+   * provider never passes through Telnyx model routing, so a region cannot be
+   * enforced for it. Omit for today's latency-based routing.
+   */
+  region?: 'USA' | 'EU' | 'AUS' | 'UAE';
+
   /**
    * The service tier to use for this request. Supported values vary by model; use
    * `GET /v2/ai/openai/models` and inspect the model's `service_tiers` field. If

package/src/resources/index.ts

@@ -772,6 +772,7 @@ export {
 } from './messaging-profile-metrics';
 export {
   MessagingProfiles,
+  type MessagingMessagingProfile,
   type MessagingProfile,
   type NumberPoolSettings,
   type URLShortenerSettings,
@@ -787,7 +788,7 @@ export {
   type MessagingProfileListShortCodesParams,
   type MessagingProfileListAlphanumericSenderIDsParams,
   type MessagingProfileRetrieveMetricsParams,
-  type MessagingProfilesDefaultFlatPagination,
+  type MessagingMessagingProfilesDefaultFlatPagination,
 } from './messaging-profiles/messaging-profiles';
 export { MessagingTollfree } from './messaging-tollfree/messaging-tollfree';
 export {

package/src/resources/messaging-profiles/actions.ts

@@ -24,7 +24,7 @@ export class Actions extends APIResource {
 }
 
 export interface ActionRegenerateSecretResponse {
-  data?: MessagingProfilesAPI.MessagingProfile;
+  data?: MessagingProfilesAPI.MessagingMessagingProfile;
 }
 
 export declare namespace Actions {

package/src/resources/messaging-profiles/index.ts

@@ -16,6 +16,7 @@ export {
 } from './autoresp-configs';
 export {
   MessagingProfiles,
+  type MessagingMessagingProfile,
   type MessagingProfile,
   type NumberPoolSettings,
   type URLShortenerSettings,
@@ -31,5 +32,5 @@ export {
   type MessagingProfileListShortCodesParams,
   type MessagingProfileListAlphanumericSenderIDsParams,
   type MessagingProfileRetrieveMetricsParams,
-  type MessagingProfilesDefaultFlatPagination,
+  type MessagingMessagingProfilesDefaultFlatPagination,
 } from './messaging-profiles';

package/src/resources/messaging-profiles/messaging-profiles.ts

@@ -41,7 +41,7 @@ export class MessagingProfiles extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const messagingProfile of client.messagingProfiles.list()) {
+   * for await (const messagingMessagingProfile of client.messagingProfiles.list()) {
    *   // ...
    * }
    * ```
@@ -49,8 +49,8 @@ export class MessagingProfiles extends APIResource {
   list(
     query: MessagingProfileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<MessagingProfilesDefaultFlatPagination, MessagingProfile> {
-    return this._client.getAPIList('/messaging_profiles', DefaultFlatPagination<MessagingProfile>, {
+  ): PagePromise<MessagingMessagingProfilesDefaultFlatPagination, MessagingMessagingProfile> {
+    return this._client.getAPIList('/messaging_profiles', DefaultFlatPagination<MessagingMessagingProfile>, {
       query,
       ...options,
     });
@@ -232,7 +232,165 @@ export class MessagingProfiles extends APIResource {
   }
 }
 
-export type MessagingProfilesDefaultFlatPagination = DefaultFlatPagination<MessagingProfile>;
+export type MessagingMessagingProfilesDefaultFlatPagination =
+  DefaultFlatPagination<MessagingMessagingProfile>;
+
+export interface MessagingMessagingProfile {
+  /**
+   * Identifies the type of resource.
+   */
+  id?: string;
+
+  /**
+   * The AI assistant ID associated with this messaging profile.
+   */
+  ai_assistant_id?: string | null;
+
+  /**
+   * The alphanumeric sender ID to use when sending to destinations that require an
+   * alphanumeric sender ID.
+   */
+  alpha_sender?: string | null;
+
+  /**
+   * ISO 8601 formatted date indicating when the resource was created.
+   */
+  created_at?: string;
+
+  /**
+   * The maximum amount of money (in USD) that can be spent by this profile before
+   * midnight UTC.
+   */
+  daily_spend_limit?: string;
+
+  /**
+   * Whether to enforce the value configured by `daily_spend_limit`.
+   */
+  daily_spend_limit_enabled?: boolean;
+
+  /**
+   * Specifies whether the messaging profile is enabled or not.
+   */
+  enabled?: boolean;
+
+  /**
+   * DEPRECATED: health check url service checking
+   */
+  health_webhook_url?: string | null;
+
+  /**
+   * enables SMS fallback for MMS messages.
+   */
+  mms_fall_back_to_sms?: boolean;
+
+  /**
+   * enables automated resizing of MMS media.
+   */
+  mms_transcoding?: boolean;
+
+  /**
+   * Send messages only to mobile phone numbers.
+   */
+  mobile_only?: boolean;
+
+  /**
+   * A user friendly name for the messaging profile.
+   */
+  name?: string;
+
+  /**
+   * Number Pool allows you to send messages from a pool of numbers of different
+   * types, assigning weights to each type. The pool consists of all the long code
+   * and toll free numbers assigned to the messaging profile.
+   *
+   * To disable this feature, set the object field to `null`.
+   */
+  number_pool_settings?: NumberPoolSettings | null;
+
+  /**
+   * The organization that owns this messaging profile.
+   */
+  organization_id?: string;
+
+  /**
+   * Identifies the type of the resource.
+   */
+  record_type?: 'messaging_profile';
+
+  /**
+   * Indicates whether message content redaction is enabled for this profile. When
+   * enabled, message text, MMS media, and the counterparty phone number are redacted
+   * in message records and reporting. Requires organization activation — contact
+   * support to enable. The field is only present in responses for organizations with
+   * redaction access.
+   */
+  redaction_enabled?: boolean;
+
+  /**
+   * Determines how much information is redacted for privacy or compliance purposes.
+   * Level 1: message records and reporting are redacted, but inbound webhook
+   * payloads are not. Level 2 (default): message records, reporting, and inbound
+   * webhook payloads are all redacted.
+   */
+  redaction_level?: number;
+
+  /**
+   * The resource group ID associated with this messaging profile.
+   */
+  resource_group_id?: string | null;
+
+  /**
+   * Enables automatic character encoding optimization for SMS messages. When
+   * enabled, the system automatically selects the most efficient encoding (GSM-7 or
+   * UCS-2) based on message content to maximize character limits and minimize costs.
+   */
+  smart_encoding?: boolean;
+
+  /**
+   * ISO 8601 formatted date indicating when the resource was updated.
+   */
+  updated_at?: string;
+
+  /**
+   * The URL shortener feature allows automatic replacement of URLs that were
+   * generated using a public URL shortener service. Some examples include bit.do,
+   * bit.ly, goo.gl, ht.ly, is.gd, ow.ly, rebrand.ly, t.co, tiny.cc, and tinyurl.com.
+   * Such URLs are replaced with with links generated by Telnyx. The use of custom
+   * links can improve branding and message deliverability.
+   *
+   * To disable this feature, set the object field to `null`.
+   */
+  url_shortener_settings?: URLShortenerSettings | null;
+
+  /**
+   * Secret used to authenticate with v1 endpoints.
+   */
+  v1_secret?: string;
+
+  /**
+   * Determines which webhook format will be used, Telnyx API v1, v2, or a legacy
+   * 2010-04-01 format.
+   */
+  webhook_api_version?: '1' | '2' | '2010-04-01';
+
+  /**
+   * The failover URL where webhooks related to this messaging profile will be sent
+   * if sending to the primary URL fails.
+   */
+  webhook_failover_url?: string | null;
+
+  /**
+   * The URL where webhooks related to this messaging profile will be sent.
+   */
+  webhook_url?: string | null;
+
+  /**
+   * Destinations to which the messaging profile is allowed to send. The elements in
+   * the list must be valid ISO 3166-1 alpha-2 country codes. If set to `["*"]`, all
+   * destinations will be allowed.
+   */
+  whitelisted_destinations?: Array<string>;
+}
 
 export interface MessagingProfile {
   /**
@@ -471,19 +629,19 @@ export interface URLShortenerSettings {
 }
 
 export interface MessagingProfileCreateResponse {
-  data?: MessagingProfile;
+  data?: MessagingMessagingProfile;
 }
 
 export interface MessagingProfileRetrieveResponse {
-  data?: MessagingProfile;
+  data?: MessagingMessagingProfile;
 }
 
 export interface MessagingProfileUpdateResponse {
-  data?: MessagingProfile;
+  data?: MessagingMessagingProfile;
 }
 
 export interface MessagingProfileDeleteResponse {
-  data?: MessagingProfile;
+  data?: MessagingMessagingProfile;
 }
 
 export interface MessagingProfileRetrieveMetricsResponse {
@@ -689,6 +847,21 @@ export interface MessagingProfileUpdateParams {
    */
   number_pool_settings?: NumberPoolSettings | null;
 
+  /**
+   * Set to true to enable message content redaction on this profile, or false to
+   * disable it. Ignored if the organization is not on the redaction allowlist. See
+   * the [Message Redaction guide](/docs/messaging/messages/message-redaction) for
+   * what is redacted.
+   */
+  redaction_enabled?: boolean;
+
+  /**
+   * The redaction level to apply when redaction is enabled. 1: redact message
+   * records and reporting only. 2 (default): also redact inbound webhook payloads.
+   * See the [Message Redaction guide](/docs/messaging/messages/message-redaction).
+   */
+  redaction_level?: number;
+
   /**
    * Enables automatic character encoding optimization for SMS messages. When
    * enabled, the system automatically selects the most efficient encoding (GSM-7 or
@@ -757,6 +930,7 @@ MessagingProfiles.Actions = Actions;
 
 export declare namespace MessagingProfiles {
   export {
+    type MessagingMessagingProfile as MessagingMessagingProfile,
     type MessagingProfile as MessagingProfile,
     type NumberPoolSettings as NumberPoolSettings,
     type URLShortenerSettings as URLShortenerSettings,
@@ -765,7 +939,7 @@ export declare namespace MessagingProfiles {
     type MessagingProfileUpdateResponse as MessagingProfileUpdateResponse,
     type MessagingProfileDeleteResponse as MessagingProfileDeleteResponse,
     type MessagingProfileRetrieveMetricsResponse as MessagingProfileRetrieveMetricsResponse,
-    type MessagingProfilesDefaultFlatPagination as MessagingProfilesDefaultFlatPagination,
+    type MessagingMessagingProfilesDefaultFlatPagination as MessagingMessagingProfilesDefaultFlatPagination,
     type MessagingProfileListParams as MessagingProfileListParams,
     type MessagingProfileCreateParams as MessagingProfileCreateParams,
     type MessagingProfileUpdateParams as MessagingProfileUpdateParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '7.20.0'; // x-release-please-version
+export const VERSION = '7.21.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.20.0";
+export declare const VERSION = "7.21.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "7.20.0";
+export declare const VERSION = "7.21.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '7.20.0'; // x-release-please-version
+exports.VERSION = '7.21.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '7.20.0'; // x-release-please-version
+export const VERSION = '7.21.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map