telnyx 6.74.2 → 7.1.0

package/src/resources/reports/reports.ts

@@ -263,22 +263,22 @@ export namespace ReportListWdrsResponse {
 
 export interface ReportListMdrsParams {
   /**
-   * Message uuid
+   * Filter results by identifier.
    */
   id?: string;
 
   /**
-   * Destination number
+   * Filter results by cld.
    */
   cld?: string;
 
   /**
-   * Origination number
+   * Filter results by cli.
    */
   cli?: string;
 
   /**
-   * Direction (inbound or outbound)
+   * Filter results by direction.
    */
   direction?: 'INBOUND' | 'OUTBOUND';
 
@@ -288,12 +288,12 @@ export interface ReportListMdrsParams {
   end_date?: string;
 
   /**
-   * Type of message
+   * Filter results by message type.
    */
   message_type?: 'SMS' | 'MMS';
 
   /**
-   * Name of the profile
+   * Filter results by profile.
    */
   profile?: string;
 
@@ -303,7 +303,7 @@ export interface ReportListMdrsParams {
   start_date?: string;
 
   /**
-   * Message status
+   * Filter results by status.
    */
   status?:
     | 'GW_TIMEOUT'
@@ -317,7 +317,7 @@ export interface ReportListMdrsParams {
 
 export interface ReportListWdrsParams extends DefaultFlatPaginationParams {
   /**
-   * WDR uuid
+   * Filter results by identifier.
    */
   id?: string;
 
@@ -327,43 +327,42 @@ export interface ReportListWdrsParams extends DefaultFlatPaginationParams {
   end_date?: string;
 
   /**
-   * International mobile subscriber identity
+   * Filter results by imsi.
    */
   imsi?: string;
 
   /**
-   * Mobile country code
+   * Filter results by mcc.
    */
   mcc?: string;
 
   /**
-   * Mobile network code
+   * Filter results by mnc.
    */
   mnc?: string;
 
   /**
-   * Phone number
+   * Filter results by phone number.
    */
   phone_number?: string;
 
   /**
-   * Sim card unique identifier
+   * Filter results by sim card id.
    */
   sim_card_id?: string;
 
   /**
-   * Sim group unique identifier
+   * Filter results by sim group id.
    */
   sim_group_id?: string;
 
   /**
-   * Sim group name
+   * Filter results by sim group name.
    */
   sim_group_name?: string;
 
   /**
-   * Field used to order the data. If no field is specified, default value is
-   * 'created_at'
+   * Field and direction to sort the results by.
    */
   sort?: Array<string>;
 

package/src/resources/reputation/index.ts

@@ -1,9 +1,4 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  Numbers,
-  type NumberRetrieveResponse,
-  type NumberRetrieveParams,
-  type NumberListParams,
-} from './numbers';
+export { Numbers, type NumberRetrieveParams, type NumberListParams } from './numbers';
 export { Reputation } from './reputation';

package/src/resources/reputation/numbers.ts

@@ -1,8 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as Shared from '../shared';
-import { ReputationPhoneNumberWithReputationDataDefaultFlatPagination } from '../shared';
+import * as ReputationNumbersAPI from '../enterprises/reputation/numbers';
+import { ReputationPhoneNumbersDefaultFlatPagination } from '../enterprises/reputation/numbers';
 import { APIPromise } from '../../core/api-promise';
 import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from '../../core/pagination';
 import { buildHeaders } from '../../internal/headers';
@@ -10,47 +10,40 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * Associate phone numbers with an enterprise for reputation monitoring and retrieve reputation scores
+ * Phone-number reputation monitoring (spam-score lookup and tracking).
  */
 export class Numbers extends APIResource {
   /**
-   * Get reputation data for a specific phone number without requiring an
-   * `enterprise_id`.
-   *
-   * Same response as the enterprise-scoped endpoint. Uses cached data by default.
+   * Convenience alias for
+   * `GET /v2/enterprises/{enterprise_id}/reputation/numbers/{phone_number}`.
    */
   retrieve(
     phoneNumber: string,
     query: NumberRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<NumberRetrieveResponse> {
+  ): APIPromise<ReputationNumbersAPI.ReputationPhoneNumberWithReputation> {
     return this._client.get(path`/reputation/numbers/${phoneNumber}`, { query, ...options });
   }
 
   /**
-   * List all phone numbers enrolled in Number Reputation monitoring for your
-   * account. This is a simplified endpoint that does not require an `enterprise_id`
-   * — it returns numbers across all your enterprises.
-   *
-   * Supports pagination and filtering by phone number.
+   * Convenience alias for `GET /v2/enterprises/{enterprise_id}/reputation/numbers`
+   * that returns numbers across every enterprise you own. Useful when you don't want
+   * to look up the enterprise id first.
    */
   list(
     query: NumberListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<
-    ReputationPhoneNumberWithReputationDataDefaultFlatPagination,
-    Shared.ReputationPhoneNumberWithReputationData
-  > {
+  ): PagePromise<ReputationPhoneNumbersDefaultFlatPagination, ReputationNumbersAPI.ReputationPhoneNumber> {
     return this._client.getAPIList(
       '/reputation/numbers',
-      DefaultFlatPagination<Shared.ReputationPhoneNumberWithReputationData>,
+      DefaultFlatPagination<ReputationNumbersAPI.ReputationPhoneNumber>,
       { query, ...options },
     );
   }
 
   /**
-   * Remove a phone number from Number Reputation monitoring without requiring an
-   * `enterprise_id`.
+   * Convenience alias for
+   * `DELETE /v2/enterprises/{enterprise_id}/reputation/numbers/{phone_number}`.
    */
   delete(phoneNumber: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/reputation/numbers/${phoneNumber}`, {
@@ -60,31 +53,33 @@ export class Numbers extends APIResource {
   }
 }
 
-export interface NumberRetrieveResponse {
-  data?: Shared.ReputationPhoneNumberWithReputationData;
-}
-
 export interface NumberRetrieveParams {
   /**
-   * When true, fetches fresh reputation data (incurs API cost). When false, returns
-   * cached data.
+   * When true, fetches fresh reputation data (incurs API cost). When false
+   * (default), returns cached data.
    */
   fresh?: boolean;
 }
 
 export interface NumberListParams extends DefaultFlatPaginationParams {
   /**
-   * Filter by specific phone number (E.164 format)
+   * Filter by enterprise ID.
+   */
+  'filter[enterprise_id]'?: string;
+
+  /**
+   * Partial match on phone number. Must contain at least 5 digits.
+   */
+  'filter[phone_number][contains]'?: string;
+
+  /**
+   * Exact phone-number match (E.164).
    */
-  phone_number?: string;
+  'filter[phone_number][eq]'?: string;
 }
 
 export declare namespace Numbers {
-  export {
-    type NumberRetrieveResponse as NumberRetrieveResponse,
-    type NumberRetrieveParams as NumberRetrieveParams,
-    type NumberListParams as NumberListParams,
-  };
+  export { type NumberRetrieveParams as NumberRetrieveParams, type NumberListParams as NumberListParams };
 }
 
-export { type ReputationPhoneNumberWithReputationDataDefaultFlatPagination };
+export { type ReputationPhoneNumbersDefaultFlatPagination };

package/src/resources/reputation/reputation.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as NumbersAPI from './numbers';
-import { NumberListParams, NumberRetrieveParams, NumberRetrieveResponse, Numbers } from './numbers';
+import { NumberListParams, NumberRetrieveParams, Numbers } from './numbers';
 
 export class Reputation extends APIResource {
   numbers: NumbersAPI.Numbers = new NumbersAPI.Numbers(this._client);
@@ -13,7 +13,6 @@ Reputation.Numbers = Numbers;
 export declare namespace Reputation {
   export {
     Numbers as Numbers,
-    type NumberRetrieveResponse as NumberRetrieveResponse,
     type NumberRetrieveParams as NumberRetrieveParams,
     type NumberListParams as NumberListParams,
   };

package/src/resources/requirements.ts

@@ -31,7 +31,7 @@ export class Requirements extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const requirementListResponse of client.requirements.list()) {
+   * for await (const docReqsRequirement of client.requirements.list()) {
    *   // ...
    * }
    * ```
@@ -39,72 +39,17 @@ export class Requirements extends APIResource {
   list(
     query: RequirementListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<RequirementListResponsesDefaultFlatPagination, RequirementListResponse> {
-    return this._client.getAPIList('/requirements', DefaultFlatPagination<RequirementListResponse>, {
+  ): PagePromise<DocReqsRequirementsDefaultFlatPagination, DocReqsRequirement> {
+    return this._client.getAPIList('/requirements', DefaultFlatPagination<DocReqsRequirement>, {
       query,
       ...options,
     });
   }
 }
 
-export type RequirementListResponsesDefaultFlatPagination = DefaultFlatPagination<RequirementListResponse>;
+export type DocReqsRequirementsDefaultFlatPagination = DefaultFlatPagination<DocReqsRequirement>;
 
-export interface RequirementRetrieveResponse {
-  data?: RequirementRetrieveResponse.Data;
-}
-
-export namespace RequirementRetrieveResponse {
-  export interface Data {
-    /**
-     * Identifies the associated document
-     */
-    id?: string;
-
-    /**
-     * Indicates whether this requirement applies to branded_calling, ordering,
-     * porting, or both ordering and porting
-     */
-    action?: 'both' | 'branded_calling' | 'ordering' | 'porting';
-
-    /**
-     * The 2-character (ISO 3166-1 alpha-2) country code where this requirement applies
-     */
-    country_code?: string;
-
-    /**
-     * ISO 8601 formatted date-time indicating when the resource was created.
-     */
-    created_at?: string;
-
-    /**
-     * The locality where this requirement applies
-     */
-    locality?: string;
-
-    /**
-     * Indicates the phone_number_type this requirement applies to. Leave blank if this
-     * requirement applies to all number_types.
-     */
-    phone_number_type?: 'local' | 'national' | 'toll_free';
-
-    /**
-     * Identifies the type of the resource.
-     */
-    record_type?: string;
-
-    /**
-     * Lists the requirement types necessary to fulfill this requirement
-     */
-    requirements_types?: Array<Shared.DocReqsRequirementType>;
-
-    /**
-     * ISO 8601 formatted date-time indicating when the resource was last updated.
-     */
-    updated_at?: string;
-  }
-}
-
-export interface RequirementListResponse {
+export interface DocReqsRequirement {
   /**
    * Identifies the associated document
    */
@@ -153,6 +98,10 @@ export interface RequirementListResponse {
   updated_at?: string;
 }
 
+export interface RequirementRetrieveResponse {
+  data?: DocReqsRequirement;
+}
+
 export interface RequirementListParams extends DefaultFlatPaginationParams {
   /**
    * Consolidated filter parameter for requirements (deepObject style). Originally:
@@ -202,9 +151,9 @@ export namespace RequirementListParams {
 
 export declare namespace Requirements {
   export {
+    type DocReqsRequirement as DocReqsRequirement,
     type RequirementRetrieveResponse as RequirementRetrieveResponse,
-    type RequirementListResponse as RequirementListResponse,
-    type RequirementListResponsesDefaultFlatPagination as RequirementListResponsesDefaultFlatPagination,
+    type DocReqsRequirementsDefaultFlatPagination as DocReqsRequirementsDefaultFlatPagination,
     type RequirementListParams as RequirementListParams,
   };
 }

package/src/resources/room-recordings.ts

@@ -24,8 +24,8 @@ export class RoomRecordings extends APIResource {
   list(
     query: RoomRecordingListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<RoomRecordingListResponsesDefaultFlatPagination, RoomRecordingListResponse> {
-    return this._client.getAPIList('/room_recordings', DefaultFlatPagination<RoomRecordingListResponse>, {
+  ): PagePromise<RoomRecordingsDefaultFlatPagination, RoomRecording> {
+    return this._client.getAPIList('/room_recordings', DefaultFlatPagination<RoomRecording>, {
       query,
       ...options,
     });
@@ -56,95 +56,9 @@ export class RoomRecordings extends APIResource {
   }
 }
 
-export type RoomRecordingListResponsesDefaultFlatPagination =
-  DefaultFlatPagination<RoomRecordingListResponse>;
+export type RoomRecordingsDefaultFlatPagination = DefaultFlatPagination<RoomRecording>;
 
-export interface RoomRecordingRetrieveResponse {
-  data?: RoomRecordingRetrieveResponse.Data;
-}
-
-export namespace RoomRecordingRetrieveResponse {
-  export interface Data {
-    /**
-     * A unique identifier for the room recording.
-     */
-    id?: string;
-
-    /**
-     * Shows the codec used for the room recording.
-     */
-    codec?: string;
-
-    /**
-     * ISO 8601 timestamp when the room recording has completed.
-     */
-    completed_at?: string;
-
-    /**
-     * ISO 8601 timestamp when the room recording was created.
-     */
-    created_at?: string;
-
-    /**
-     * Url to download the recording.
-     */
-    download_url?: string;
-
-    /**
-     * Shows the room recording duration in seconds.
-     */
-    duration_secs?: number;
-
-    /**
-     * ISO 8601 timestamp when the room recording has ended.
-     */
-    ended_at?: string;
-
-    /**
-     * Identify the room participant associated with the room recording.
-     */
-    participant_id?: string;
-
-    record_type?: string;
-
-    /**
-     * Identify the room associated with the room recording.
-     */
-    room_id?: string;
-
-    /**
-     * Identify the room session associated with the room recording.
-     */
-    session_id?: string;
-
-    /**
-     * Shows the room recording size in MB.
-     */
-    size_mb?: number;
-
-    /**
-     * ISO 8601 timestamp when the room recording has stated.
-     */
-    started_at?: string;
-
-    /**
-     * Shows the room recording status.
-     */
-    status?: 'completed' | 'processing';
-
-    /**
-     * Shows the room recording type.
-     */
-    type?: 'audio' | 'video';
-
-    /**
-     * ISO 8601 timestamp when the room recording was updated.
-     */
-    updated_at?: string;
-  }
-}
-
-export interface RoomRecordingListResponse {
+export interface RoomRecording {
   /**
    * A unique identifier for the room recording.
    */
@@ -223,6 +137,10 @@ export interface RoomRecordingListResponse {
   updated_at?: string;
 }
 
+export interface RoomRecordingRetrieveResponse {
+  data?: RoomRecording;
+}
+
 export interface RoomRecordingDeleteBulkResponse {
   data?: RoomRecordingDeleteBulkResponse.Data;
 }
@@ -430,10 +348,10 @@ export namespace RoomRecordingDeleteBulkParams {
 
 export declare namespace RoomRecordings {
   export {
+    type RoomRecording as RoomRecording,
     type RoomRecordingRetrieveResponse as RoomRecordingRetrieveResponse,
-    type RoomRecordingListResponse as RoomRecordingListResponse,
     type RoomRecordingDeleteBulkResponse as RoomRecordingDeleteBulkResponse,
-    type RoomRecordingListResponsesDefaultFlatPagination as RoomRecordingListResponsesDefaultFlatPagination,
+    type RoomRecordingsDefaultFlatPagination as RoomRecordingsDefaultFlatPagination,
     type RoomRecordingListParams as RoomRecordingListParams,
     type RoomRecordingDeleteBulkParams as RoomRecordingDeleteBulkParams,
   };

package/src/resources/shared.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import * as Shared from './shared';
-import * as MessagesAPI from './messages/messages';
 import { DefaultFlatPagination } from '../core/pagination';
 
 export interface APIError {
@@ -389,7 +388,7 @@ export interface InboundMessagePayload {
    * These errors may point at addressees when referring to unsuccessful/unconfirmed
    * delivery statuses.
    */
-  errors?: Array<MessagesAPI.MessagingError>;
+  errors?: Array<MessagingError>;
 
   from?: InboundMessagePayload.From;
 
@@ -635,6 +634,40 @@ export interface InworldVoiceSettings {
    * Voice settings provider type
    */
   type: 'inworld';
+
+  /**
+   * Controls the expressiveness and consistency of the Inworld `TTS2` model's speech
+   * synthesis. `STABLE` favors consistent, predictable output, `CREATIVE` allows
+   * more expressive variation, and `BALANCED` sits in between. Optional and only
+   * supported by `TTS2`; when omitted, the provider default applies.
+   */
+  delivery_mode?: 'STABLE' | 'BALANCED' | 'CREATIVE';
+}
+
+export interface MessagingError {
+  code: string;
+
+  title: string;
+
+  detail?: string;
+
+  meta?: { [key: string]: unknown };
+
+  source?: MessagingError.Source;
+}
+
+export namespace MessagingError {
+  export interface Source {
+    /**
+     * Indicates which query parameter caused the error.
+     */
+    parameter?: string;
+
+    /**
+     * JSON pointer (RFC6901) to the offending entity.
+     */
+    pointer?: string;
+  }
 }
 
 /**
@@ -703,28 +736,6 @@ export interface MessagingPaginationMeta {
   total_results: number;
 }
 
-export interface MetaInfo {
-  /**
-   * Current page number
-   */
-  page_number?: number;
-
-  /**
-   * Items per page
-   */
-  page_size?: number;
-
-  /**
-   * Total number of pages
-   */
-  total_pages?: number;
-
-  /**
-   * Total number of results
-   */
-  total_results?: number;
-}
-
 export interface Metadata {
   /**
    * Current Page based on pagination settings (included when defaults are used.)
@@ -1038,77 +1049,31 @@ export interface RegionInformation {
 }
 
 /**
- * Reputation metrics
+ * Reputation snapshot for a phone number. Each metric is a 0–100 score;
+ * `spam_risk` is a coarse bucket. Field set may grow over time - read by key.
  */
 export interface ReputationData {
-  /**
-   * Connection quality metric (0–100)
-   */
   connection_score?: number | null;
 
-  /**
-   * Engagement metric (0–100). Higher = more positive engagement
-   */
   engagement_score?: number | null;
 
-  /**
-   * Timestamp of the last reputation data refresh
-   */
   last_refreshed_at?: string | null;
 
-  /**
-   * Maturity metric (0–100). Higher = more established number
-   */
   maturity_score?: number | null;
 
-  /**
-   * Sentiment metric (0–100). Higher = more positive sentiment
-   */
   sentiment_score?: number | null;
 
   /**
-   * Spam category classification (e.g., Telemarketing, Debt Collector)
+   * Category label from the reputation feed when the number is flagged.
    */
   spam_category?: string | null;
 
   /**
-   * Overall spam risk level
+   * Overall spam-risk classification.
    */
   spam_risk?: 'low' | 'medium' | 'high' | null;
 }
 
-export interface ReputationPhoneNumberWithReputationData {
-  /**
-   * Unique identifier
-   */
-  id?: string;
-
-  /**
-   * When the number was associated
-   */
-  created_at?: string;
-
-  /**
-   * ID of the associated enterprise
-   */
-  enterprise_id?: string;
-
-  /**
-   * Phone number in E.164 format
-   */
-  phone_number?: string;
-
-  /**
-   * Reputation metrics
-   */
-  reputation_data?: ReputationData;
-
-  /**
-   * When the record was last updated
-   */
-  updated_at?: string;
-}
-
 export interface ResembleVoiceSettings {
   /**
    * Voice settings provider type
@@ -1460,6 +1425,3 @@ export type RoomParticipantsDefaultFlatPagination = DefaultFlatPagination<RoomPa
 export type SimpleSimCardsDefaultFlatPagination = DefaultFlatPagination<SimpleSimCard>;
 
 export type WhatsappTemplateDataDefaultFlatPagination = DefaultFlatPagination<WhatsappTemplateData>;
-
-export type ReputationPhoneNumberWithReputationDataDefaultFlatPagination =
-  DefaultFlatPagination<ReputationPhoneNumberWithReputationData>;