telnyx 5.168.0 → 5.170.0

data/rbi/telnyx/resources/bot_signup.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA
+    # challenge designed to be easy for LLMs and hard for humans, registers an
+    # account, and signs in by consuming a magic link emailed to the account owner.
+    # All endpoints are public and unauthenticated; signup endpoints are additionally
+    # gated by the freemium feature flags and per-country availability.
+    class BotSignup
+      # Creates a freemium Telnyx account through the agentic signup flow. The request
+      # must carry a valid answer to a previously issued bot challenge
+      # (`bot_challenge_nonce` and `bot_challenge_answer`), accept the terms of service,
+      # and echo the exact terms-and-conditions and privacy-policy URLs returned by the
+      # challenge endpoint. When EU consent enforcement is enabled,
+      # `terms_of_service_eu` and `terms_and_conditions_eu_url` are also required. On
+      # success a one-time sign-in (magic) link is emailed to the address provided; if
+      # the email address belongs to an existing account, a sign-in link is sent instead
+      # of creating a duplicate account. `email` may only be omitted when
+      # placeholder-email registration is enabled server-side. This endpoint is public
+      # and unauthenticated, gated by the freemium feature flags and per-country
+      # availability, and subject to per-IP and per-domain registration limits.
+      sig do
+        params(
+          bot_challenge_answer: String,
+          bot_challenge_nonce: String,
+          privacy_policy_url: String,
+          terms_and_conditions_url: String,
+          terms_of_service:
+            Telnyx::BotSignupCreateParams::TermsOfService::OrBoolean,
+          email: String,
+          terms_and_conditions_eu_url: String,
+          terms_of_service_eu:
+            Telnyx::BotSignupCreateParams::TermsOfServiceEu::OrBoolean,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::SuccessResponse)
+      end
+      def create(
+        # Answer to the issued bot challenge.
+        bot_challenge_answer:,
+        # Nonce from a previously issued bot challenge.
+        bot_challenge_nonce:,
+        # Must exactly match the privacy-policy URL returned by the challenge endpoint.
+        privacy_policy_url:,
+        # Must exactly match the terms-and-conditions URL returned by the challenge
+        # endpoint.
+        terms_and_conditions_url:,
+        # Must be true to accept the terms of service.
+        terms_of_service:,
+        # Email address for the new account. The magic link is sent here. May only be
+        # omitted when placeholder-email registration is enabled server-side.
+        email: nil,
+        # EU terms-and-conditions URL. Required when EU consent enforcement is enabled.
+        terms_and_conditions_eu_url: nil,
+        # EU terms-of-service acceptance. Required when EU consent enforcement is enabled.
+        terms_of_service_eu: nil,
+        request_options: {}
+      )
+      end
+
+      # Resends the one-time sign-in (magic) link for an eligible bot signup account.
+      # Eligibility (account exists, was registered through bot signup, is active, and
+      # has not exceeded the resend limit or rate window) is evaluated server-side; the
+      # response is intentionally uniform and does not reveal whether the account exists
+      # or whether a link was actually sent. This endpoint is public and
+      # unauthenticated, gated by the freemium feature flags and per-country
+      # availability.
+      sig do
+        params(
+          email: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::SuccessResponse)
+      end
+      def resend_magic_link(
+        # Email address of the bot signup account to resend the magic link to.
+        email:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Telnyx::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/calls/actions.rbi

@@ -467,7 +467,8 @@ module Telnyx
                 Telnyx::Calls::AwsVoiceSettings::OrHash,
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionGatherUsingAIResponse)
@@ -547,6 +548,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -686,7 +693,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionGatherUsingSpeakResponse)
@@ -740,6 +748,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -1208,7 +1222,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionSpeakResponse)
@@ -1262,6 +1277,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -1423,7 +1444,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Calls::ActionStartConversationRelayResponse)
@@ -1526,6 +1548,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -2374,11 +2402,12 @@ module Telnyx
           command_id: nil,
           # Custom headers to be added to the SIP INVITE.
           custom_headers: nil,
-          # The number the inbound call being transferred was originally received on, in
-          # +E164 format. Supplying it lets an unverified non-Telnyx `from` be used as the
-          # caller id, provided that number is still on an active inbound call to this
-          # `diversion` number for your account. The `diversion` number itself must be one
-          # you own or have verified.
+          # The `to` number of an active inbound call, in +E164 format. Telnyx checks
+          # whether there is currently an active inbound call where `to` matches this
+          # `diversion` value and `from` matches the `from` number supplied for this
+          # request. If such a call exists, the `from` number is treated as verified (since
+          # it is already on an active inbound call to you) and can be used as the caller id
+          # for this outbound call.
           diversion: nil,
           # If set to false, early media will not be passed to the originating leg.
           early_media: nil,

data/rbi/telnyx/resources/calls.rbi

@@ -198,11 +198,12 @@ module Telnyx
         # webhook.
         deepfake_detection: nil,
         dialogflow_config: nil,
-        # The number the inbound call being transferred was originally received on, in
-        # +E164 format. Supplying it lets an unverified non-Telnyx `from` be used as the
-        # caller id, provided that number is still on an active inbound call to this
-        # `diversion` number for your account. The `diversion` number itself must be one
-        # you own or have verified.
+        # The `to` number of an active inbound call, in +E164 format. Telnyx checks
+        # whether there is currently an active inbound call where `to` matches this
+        # `diversion` value and `from` matches the `from` number supplied for this
+        # request. If such a call exists, the `from` number is treated as verified (since
+        # it is already on an active inbound call to you) and can be used as the caller id
+        # for this outbound call.
         diversion: nil,
         # Enables Dialogflow for the current call. The default value is false.
         enable_dialogflow: nil,

data/rbi/telnyx/resources/compute/funcs/export.rbi

@@ -0,0 +1,86 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class Compute
+      class Funcs
+        class Export
+          # Configures the external OTLP endpoint a function's runtime and/or invocation
+          # logs are pushed to as they happen. This operation is a **full replace, not a
+          # patch**: `endpoint`, `headers`, `runtime_export_enabled`, and
+          # `invocation_export_enabled` are all required on every call — omitting any of
+          # them is a 422, not "keep the current value". Headers are encrypted at rest and
+          # never returned in any response.
+          #
+          # The endpoint must be an HTTPS URL. When export is configured, new log records
+          # are converted to OTLP log records and delivered continuously; export never
+          # bypasses platform log storage, and delivery retries with a bounded policy while
+          # the destination is unreachable. Only logs generated after configuration are
+          # exported — there is no historical replay.
+          sig do
+            params(
+              id: String,
+              endpoint: String,
+              headers: T::Hash[Symbol, String],
+              invocation_export_enabled: T::Boolean,
+              runtime_export_enabled: T::Boolean,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(Telnyx::Compute::Funcs::FuncLogExportConfigResponse)
+          end
+          def create(
+            # Function ID
+            id,
+            # HTTPS URL to push logs to
+            endpoint:,
+            # Headers attached to every export push, as key-value pairs (e.g. an auth token
+            # the collector expects). Required even when empty — {} means "no headers".
+            # Encrypted at rest; never returned.
+            headers:,
+            # Export invocation records (one per HTTP request) to this destination
+            invocation_export_enabled:,
+            # Export runtime logs (function stdout/stderr) to this destination
+            runtime_export_enabled:,
+            request_options: {}
+          )
+          end
+
+          # Returns the function's configured log export destination and which log types are
+          # exported. Headers are never returned. Returns 404 (error code 10005) when no
+          # destination is configured for the function.
+          sig do
+            params(
+              id: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(Telnyx::Compute::Funcs::FuncLogExportConfigResponse)
+          end
+          def list(
+            # Function ID
+            id,
+            request_options: {}
+          )
+          end
+
+          # Stops exporting a function's logs and removes its destination configuration.
+          # Idempotent: deleting when nothing is configured succeeds.
+          sig do
+            params(
+              id: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).void
+          end
+          def delete_all(
+            # Function ID
+            id,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/compute/funcs.rbi

@@ -4,6 +4,9 @@ module Telnyx
   module Resources
     class Compute
       class Funcs
+        sig { returns(Telnyx::Resources::Compute::Funcs::Export) }
+        attr_reader :export
+
         # Returns logs oldest first. `type=runtime` (default) returns function
         # stdout/stderr. `type=invocations` returns one platform-generated record per HTTP
         # request served.

data/rbi/telnyx/resources/conferences/actions.rbi

@@ -534,7 +534,8 @@ module Telnyx
                 Telnyx::AzureVoiceSettings::OrHash,
                 Telnyx::ResembleVoiceSettings::OrHash,
                 Telnyx::InworldVoiceSettings::OrHash,
-                Telnyx::XaiVoiceSettings::OrHash
+                Telnyx::XaiVoiceSettings::OrHash,
+                Telnyx::Calls::SonioxVoiceSettings::OrHash
               ),
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(Telnyx::Models::Conferences::ActionSpeakResponse)
@@ -588,6 +589,12 @@ module Telnyx
           # - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
           #   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
           #   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+          # - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+          #   Supported model: `tts-rt-v2`. Browse the catalog via the
+          #   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+          #   Every voice speaks all supported languages; set `language` to the two-letter
+          #   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+          #   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
           # - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
           #   `ara`, `rex`, `sal`, `leo`.
           # - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:

data/rbi/telnyx/resources/connections.rbi

@@ -78,6 +78,17 @@ module Telnyx
       )
       end
 
+      # Returns the number of connections associated with the authenticated user,
+      # grouped by connection type, together with the connection limits that apply to
+      # the user. Forward-only connections are excluded from the counts.
+      sig do
+        params(request_options: Telnyx::RequestOptions::OrHash).returns(
+          Telnyx::Models::ConnectionRetrieveCountResponse
+        )
+      end
+      def retrieve_count(request_options: {})
+      end
+
       # @api private
       sig { params(client: Telnyx::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/telnyx/resources/detail_records.rbi

@@ -21,10 +21,21 @@ module Telnyx
       def list(
         # Filter records on a given record attribute and value. <br/>Example:
         # filter[status]=delivered. <br/>Required: filter[record_type] must be specified.
+        # <br/>The valid filter fields depend on the record_type: filtering by a field
+        # that does not exist for the selected record_type is rejected with a 400 error.
+        # Call-control and sip-trunking records use started_at, finished_at and
+        # answered_at (they have no created_at); messaging records use created_at. To list
+        # the fields available for a record_type, use the /v2/detail_records/options
+        # endpoint.
         filter: nil,
         page_number: nil,
         page_size: nil,
-        # Specifies the sort order for results. <br/>Example: sort=-created_at
+        # Specifies the sort order for results. <br/>Example: sort=-created_at <br/>The
+        # valid sort fields depend on the record_type: sort by a field that does not exist
+        # for the selected record_type is rejected with a 400 error. Call-control and
+        # sip-trunking records use started_at, finished_at and answered_at (they have no
+        # created_at); messaging records use created_at. To list the fields available for
+        # a record_type, use the /v2/detail_records/options endpoint.
         sort: nil,
         request_options: {}
       )

data/rbi/telnyx/resources/email_blocks/imports.rbi

@@ -13,9 +13,23 @@ module Telnyx
         # - header-only / all-blank / undetectable provider → `400` Returns `202` with the
         #   import record (status `pending`); an Oban worker (`EmailBlockImportWorker`,
         #   max_attempts 3) transitions `pending → processing → completed | failed`.
-        #   `block_ttl_days` applies only to imported `manual_block` rows; other reasons
-        #   get `expires_at: nil`. Provider is auto-detected from the CSV header
-        #   (`sendgrid` / `mailgun` / `ses` / `generic`).
+        #
+        # Native Telnyx exports are detected by the stable first-12-column header
+        # signature (`id` … `group_id`) and are restored with their original `from`,
+        # `domain_id`, `group_id`, `source`, `status`, `expires_at`, plus
+        # `bounce_category`, `dsn_code`, and `meta` when present (`scope` is re-derived
+        # from `domain_id`/`from`; the exported `scope` cell must be a valid enum value).
+        # Lifecycle changes reconcile through the same create path as the API: a row
+        # already in the requested state restores its mutable backup fields without a new
+        # audit event, and a real transition (e.g. tombstone → active) appends the
+        # matching lifecycle event. `block_ttl_days` is not applied to native rows — their
+        # exported `expires_at` is preserved verbatim.
+        #
+        # Competitor and generic imports (SendGrid / Mailgun / SES / generic) remain
+        # account-scoped (`from`, `domain_id`, `group_id`, `scope` are not read) and
+        # `block_ttl_days` applies only to imported `manual_block` rows; other reasons get
+        # `expires_at: nil`. Provider is auto-detected from the CSV header (`sendgrid` /
+        # `mailgun` / `ses` / `generic`).
         sig do
           params(
             file: Telnyx::Internal::FileInput,

data/rbi/telnyx/resources/email_blocks.rbi

@@ -158,9 +158,11 @@ module Telnyx
       # stream `ORDER BY created_at ASC, id ASC` with no pagination.
       #
       # CSV columns:
-      # `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id`.
-      # The CSV carries the `group_id` column so group-scoped suppressions' group link
-      # survives the export (empty for account-scope rows).
+      # `id,to,from,reason,source,scope,status,domain_id, created_at,updated_at,expires_at,group_id,bounce_category,dsn_code, meta`
+      # (15 columns). The first 12 columns are the stable native signature;
+      # `bounce_category`, `dsn_code`, and `meta` are optional backup fields (empty when
+      # unset). The CSV carries the `group_id` column so group-scoped suppressions'
+      # group link survives the export (empty for account-scope rows).
       sig do
         params(
           filter_created_after: Time,

data/rbi/telnyx/resources/email_domains.rbi

@@ -167,6 +167,28 @@ module Telnyx
       )
       end
 
+      # Generates a new DKIM key for the domain, activates it, and retires the previous
+      # key. The response includes the updated DKIM DNS records the customer must
+      # publish. Selectors are fixed, so rotation replaces the TXT value at the existing
+      # `<selector>._domainkey.<domain>` host rather than adding a second record —
+      # `old_selector_retained` is false and the new TXT value must be published
+      # promptly, since signing switches to the new key immediately and the old TXT
+      # value will no longer match. The previous key is retired to a `retiring` state
+      # (retained, not revoked) so it can be revoked after the DNS propagation grace
+      # period.
+      sig do
+        params(
+          domain_id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::EmailDomainRotateDkimResponse)
+      end
+      def rotate_dkim(
+        # Email domain UUID
+        domain_id,
+        request_options: {}
+      )
+      end
+
       # Checks the published DNS records against the records required for the email
       # domain and returns the latest verification results.
       sig do

data/rbi/telnyx/resources/email_events.rbi

@@ -5,21 +5,30 @@ module Telnyx
     # Retrieve account-level email events and event statistics.
     class EmailEvents
       # Lists account-level email events sorted oldest first by
-      # `occurred_at asc, id asc`.
+      # `occurred_at asc, id asc`. Each row contains a legacy email.-prefixed event_type
+      # and an additive canonical_event_type. Gateway rejection renders email.failed
+      # with canonical email.gw_reject; ambiguous injection timeout renders
+      # email.injection_timeout in both; MTA expiration renders email.bounced with
+      # canonical email.expired. Message-scoped queued, sending, sandbox, cancelled, and
+      # daily_limit_exceeded rows fan out per durable recipient with stable derived IDs
+      # matching webhook delivery. Scheduled is the cardinality exception: account
+      # polling retains one message-scoped scheduled row with its stored event ID, while
+      # scheduled webhook publication fans out per recipient with derived IDs; reconcile
+      # scheduled events by message ID, event type, and occurrence time rather than
+      # event UUID. Recipient-scoped stored rows retain their stored UUIDs across
+      # polling and webhook delivery. Legacy names are derived from stored rows; an
+      # AdminBounce row stored as failed renders email.failed in polling while its
+      # webhook retains email.bounced, both with canonical email.failed.
       sig do
         params(
           email_id: String,
           event_type: Telnyx::EmailEventListParams::EventType::Variants,
           from: Time,
-          page_cursor: String,
           page_size: Integer,
+          page_cursor: String,
           to: Time,
           request_options: Telnyx::RequestOptions::OrHash
-        ).returns(
-          Telnyx::Internal::EmailCursorPagination[
-            Telnyx::Models::EmailEventListResponse
-          ]
-        )
+        ).returns(Telnyx::Models::EmailEventListResponse)
       end
       def list(
         # Filter events for a specific email message UUID. Invalid UUID values are
@@ -28,14 +37,26 @@ module Telnyx
         # Comma-separated list of event types to include. Also accepts repeated query
         # parameters (e.g. event_type=delivered&event_type=bounced). Unknown values return
         # no matches.
+        #
+        # Dual-name compatibility: values are accepted bare or `email.`-prefixed. A legacy
+        # value keeps matching the rows it matched pre-rename — no widening: `failed` also
+        # matches the rows that now store the canonical names of the outcomes it covered
+        # (`gw_reject`, `injection_timeout`, `expired`); `bounced` matches stored
+        # `bounced` rows only (recipient-scoped Expirations stored `failed` pre-rename and
+        # never matched `bounced`, so `expired` is deliberately not a `bounced`
+        # expansion). A canonical value matches its own rows plus legacy rows whose
+        # recorded payload evidence proves that outcome (`expired` also surfaces legacy
+        # `bounced` rows with `bounce_category: transient`). The additive
+        # `canonical_event_type` field in each response row names the canonical outcome.
         event_type: nil,
         # Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.
         from: nil,
-        # Opaque URL-safe Base64 cursor returned by a previous list response.
-        page_cursor: nil,
         # Number of results to return. Defaults to 25; maximum is 100. Invalid values are
         # clamped to the valid range.
         page_size: nil,
+        # Opaque URL-safe Base64 cursor returned by a previous event list response. The
+        # legacy `page[after]` and flat `page_cursor` forms are also accepted.
+        page_cursor: nil,
         # Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
         # to `from + 30 days`.
         to: nil,