telnyx 7.26.0 → 7.28.0

package/src/resources/messages/rcs.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from './messages';
 import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -43,8 +44,16 @@ export class Rcs extends APIResource {
    * });
    * ```
    */
-  send(body: RcSendParams, options?: RequestOptions): APIPromise<RcSendResponse> {
-    return this._client.post('/messages/rcs', { body, ...options });
+  send(params: RcSendParams, options?: RequestOptions): APIPromise<RcSendResponse> {
+    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+    return this._client.post('/messages/rcs', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+        options?.headers,
+      ]),
+    });
   }
 }
 
@@ -128,35 +137,56 @@ export interface RcGenerateDeeplinkParams {
 
 export interface RcSendParams {
   /**
-   * RCS Agent ID
+   * Body param: RCS Agent ID
    */
   agent_id: string;
 
+  /**
+   * Body param
+   */
   agent_message: MessagesAPI.RcsAgentMessage;
 
   /**
-   * A valid messaging profile ID
+   * Body param: A valid messaging profile ID
    */
   messaging_profile_id: string;
 
   /**
-   * Phone number in +E.164 format
+   * Body param: Phone number in +E.164 format
    */
   to: string;
 
+  /**
+   * Body param
+   */
   mms_fallback?: RcSendParams.MmsFallback;
 
+  /**
+   * Body param
+   */
   sms_fallback?: RcSendParams.SMSFallback;
 
   /**
-   * Message type - must be set to "RCS"
+   * Body param: Message type - must be set to "RCS"
    */
   type?: 'RCS';
 
   /**
-   * The URL where webhooks related to this message will be sent.
+   * Body param: The URL where webhooks related to this message will be sent.
    */
   webhook_url?: string;
+
+  /**
+   * Header param: Optional opaque, unquoted key for safely retrying the same logical
+   * request. Keys must contain 1 to 255 letters, numbers, hyphens, or underscores.
+   * Generate a unique UUID v4 for each operation and reuse it only when retrying
+   * that operation with the same request. Invalid headers—including duplicate,
+   * empty, malformed, or overlong values—return 400 with error code 10015. A request
+   * already in progress with the same key returns 409; reusing the key with a
+   * different request returns 422. Only successful responses are replayed, for up to
+   * 24 hours. Do not include sensitive data in the key.
+   */
+  'Idempotency-Key'?: string;
 }
 
 export namespace RcSendParams {

package/src/resources/network-coverage.ts

@@ -23,7 +23,11 @@ export class NetworkCoverage extends APIResource {
 export type NetworkCoverageListResponsesDefaultFlatPagination =
   DefaultFlatPagination<NetworkCoverageListResponse>;
 
-export type AvailableService = 'cloud_vpn' | 'private_wireless_gateway' | 'virtual_cross_connect';
+export type AvailableService =
+  | 'cloud_vpn'
+  | 'private_wireless_gateway'
+  | 'tailscale_subnet_router'
+  | 'virtual_cross_connect';
 
 export interface NetappsLocation17904fcfbc {
   /**

package/src/resources/number-lookup.ts

@@ -27,6 +27,12 @@ export interface NumberLookupRetrieveResponse {
 
 export namespace NumberLookupRetrieveResponse {
   export interface Data {
+    /**
+     * Identity information for the phone number's owner, including name and postal
+     * address. Populated when `type=caller-identity` is requested.
+     */
+    caller_identity?: Data.CallerIdentity;
+
     caller_name?: Data.CallerName;
 
     carrier?: Data.Carrier;
@@ -36,6 +42,12 @@ export namespace NumberLookupRetrieveResponse {
      */
     country_code?: string;
 
+    /**
+     * Enhanced caller name for the phone number's owner. Populated when
+     * `type=enhanced-caller-name` is requested.
+     */
+    enhanced_caller_name?: Data.EnhancedCallerName;
+
     /**
      * Unused
      */
@@ -47,6 +59,12 @@ export namespace NumberLookupRetrieveResponse {
      */
     national_format?: string;
 
+    /**
+     * Network number ID (NNID) override for the phone number, when one applies
+     * (available only to accounts enabled for NNID); otherwise null.
+     */
+    nnid_override?: Data.NnidOverride | null;
+
     /**
      * E164-formatted phone number
      */
@@ -58,9 +76,87 @@ export namespace NumberLookupRetrieveResponse {
      * Identifies the type of record
      */
     record_type?: string;
+
+    /**
+     * Indicates whether the phone number is valid.
+     */
+    valid_number?: boolean;
   }
 
   export namespace Data {
+    /**
+     * Identity information for the phone number's owner, including name and postal
+     * address. Populated when `type=caller-identity` is requested.
+     */
+    export interface CallerIdentity {
+      /**
+       * Postal address associated with the phone number's owner.
+       */
+      address?: CallerIdentity.Address;
+
+      /**
+       * How strongly the phone number is linked to the returned name, on a scale of 50
+       * to 90 (higher means more supporting signals). Reflects signal strength, not
+       * probability: 70 indicates stronger, more consistent evidence than 60, not a 70%
+       * chance of being correct. As a guide, 70+ is high confidence, 60 moderate, and 50
+       * limited. Below 50 no name is returned, so scores under 50 are never present.
+       */
+      confidence_score?: number | null;
+
+      /**
+       * A lookup-specific error code if the identity could not be resolved; otherwise
+       * null.
+       */
+      error_code?: string | null;
+
+      /**
+       * The name associated with the phone number.
+       */
+      name?: string | null;
+    }
+
+    export namespace CallerIdentity {
+      /**
+       * Postal address associated with the phone number's owner.
+       */
+      export interface Address {
+        /**
+         * City.
+         */
+        city?: string | null;
+
+        /**
+         * Two-letter ISO 3166-1 country code.
+         */
+        country_code?: string | null;
+
+        /**
+         * Postal or ZIP code.
+         */
+        postal_code?: string | null;
+
+        /**
+         * Two-letter state or province code.
+         */
+        state_code?: string | null;
+
+        /**
+         * First line of the street address.
+         */
+        street_line_1?: string | null;
+
+        /**
+         * Second line of the street address, if any.
+         */
+        street_line_2?: string | null;
+
+        /**
+         * ZIP+4 extension, if available.
+         */
+        zip4?: string | null;
+      }
+    }
+
     export interface CallerName {
       /**
        * The name of the requested phone number's owner as per the CNAM database
@@ -122,6 +218,44 @@ export namespace NumberLookupRetrieveResponse {
         | 'unknown';
     }
 
+    /**
+     * Enhanced caller name for the phone number's owner. Populated when
+     * `type=enhanced-caller-name` is requested.
+     */
+    export interface EnhancedCallerName {
+      /**
+       * The name associated with the phone number.
+       */
+      caller_name?: string | null;
+
+      /**
+       * A lookup-specific error code if the enhanced caller name could not be resolved;
+       * otherwise null.
+       */
+      error_code?: string | null;
+    }
+
+    /**
+     * Network number ID (NNID) override for the phone number, when one applies
+     * (available only to accounts enabled for NNID); otherwise null.
+     */
+    export interface NnidOverride {
+      /**
+       * Name associated with the NNID.
+       */
+      name?: string;
+
+      /**
+       * The network number ID.
+       */
+      nnid?: string;
+
+      /**
+       * The NNID type.
+       */
+      type?: string;
+    }
+
     export interface Portability {
       /**
        * Alternative SPID (Service Provider ID). Often used when a carrier is using a
@@ -146,9 +280,22 @@ export namespace NumberLookupRetrieveResponse {
       city?: string;
 
       /**
-       * Type of number
+       * The line type of the phone number. Uses the same value set as carrier.type; see
+       * the API reference for the full list.
        */
-      line_type?: string;
+      line_type?:
+        | 'fixed line'
+        | 'mobile'
+        | 'voip'
+        | 'fixed line or mobile'
+        | 'toll free'
+        | 'premium rate'
+        | 'shared cost'
+        | 'personal number'
+        | 'pager'
+        | 'uan'
+        | 'voicemail'
+        | 'unknown';
 
       /**
        * Local Routing Number, if assigned to the requested phone number
@@ -193,9 +340,12 @@ export namespace NumberLookupRetrieveResponse {
 
 export interface NumberLookupRetrieveParams {
   /**
-   * Specifies the type of number lookup to be performed
+   * Specifies the type of number lookup to be performed. May be supplied more than
+   * once to request several data sources in a single call (for example,
+   * `?type=carrier&type=enhanced-caller-name`). Each requested type populates the
+   * corresponding object in the response.
    */
-  type?: 'carrier' | 'caller-name';
+  type?: 'carrier' | 'caller-name' | 'caller-identity' | 'enhanced-caller-name';
 }
 
 export declare namespace NumberLookup {

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

@@ -44,8 +44,11 @@ export class CsvDownloads extends APIResource {
     params: CsvDownloadCreateParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<CsvDownloadCreateResponse> {
-    const { csv_format, filter } = params ?? {};
-    return this._client.post('/phone_numbers/csv_downloads', { query: { csv_format, filter }, ...options });
+    const { csv_format, filter, include_managed_accounts } = params ?? {};
+    return this._client.post('/phone_numbers/csv_downloads', {
+      query: { csv_format, filter, include_managed_accounts },
+      ...options,
+    });
   }
 
   /**
@@ -113,6 +116,16 @@ export interface CsvDownloadCreateParams {
    * filter[emergency_address_id], filter[customer_reference]
    */
   filter?: CsvDownloadCreateParams.Filter;
+
+  /**
+   * When true, the CSV includes phone numbers from all managed accounts in addition
+   * to the requesting account's own numbers. Only applies to V2 format; ignored for
+   * V1. The export appends `user_id` and `email` columns identifying the account
+   * that owns each number. When a filter is provided, it applies to the combined set
+   * of numbers. Requires access to managed accounts; requests without that access
+   * are rejected.
+   */
+  include_managed_accounts?: boolean;
 }
 
 export namespace CsvDownloadCreateParams {

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

@@ -22,6 +22,7 @@ export {
 } from './csv-downloads';
 export {
   Jobs,
+  type NumbersPhoneNumbersJob,
   type PhoneNumbersJob,
   type JobRetrieveResponse,
   type JobDeleteBatchResponse,
@@ -31,7 +32,7 @@ export {
   type JobDeleteBatchParams,
   type JobUpdateEmergencySettingsBatchParams,
   type JobUpdateBatchParams,
-  type PhoneNumbersJobsDefaultFlatPagination,
+  type NumbersPhoneNumbersJobsDefaultFlatPagination,
 } from './jobs';
 export {
   Messaging,
@@ -42,6 +43,7 @@ export {
 } from './messaging';
 export {
   PhoneNumbers,
+  type NumbersError73c9788e53,
   type NumbersPhoneNumberDetailed,
   type PhoneNumberDetailed,
   type PhoneNumberRetrieveResponse,