telnyx 5.168.0 → 5.170.0

data/lib/telnyx/resources/bot_signup.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+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
+      # Some parameter documentations has been truncated, see
+      # {Telnyx::Models::BotSignupCreateParams} for more details.
+      #
+      # 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.
+      #
+      # @overload create(bot_challenge_answer:, bot_challenge_nonce:, privacy_policy_url:, terms_and_conditions_url:, terms_of_service:, email: nil, terms_and_conditions_eu_url: nil, terms_of_service_eu: nil, request_options: {})
+      #
+      # @param bot_challenge_answer [String] Answer to the issued bot challenge.
+      #
+      # @param bot_challenge_nonce [String] Nonce from a previously issued bot challenge.
+      #
+      # @param privacy_policy_url [String] Must exactly match the privacy-policy URL returned by the challenge endpoint.
+      #
+      # @param terms_and_conditions_url [String] Must exactly match the terms-and-conditions URL returned by the challenge endpoi
+      #
+      # @param terms_of_service [Boolean, Telnyx::Models::BotSignupCreateParams::TermsOfService] Must be true to accept the terms of service.
+      #
+      # @param email [String] Email address for the new account. The magic link is sent here. May only be omit
+      #
+      # @param terms_and_conditions_eu_url [String] EU terms-and-conditions URL. Required when EU consent enforcement is enabled.
+      #
+      # @param terms_of_service_eu [Boolean, Telnyx::Models::BotSignupCreateParams::TermsOfServiceEu] EU terms-of-service acceptance. Required when EU consent enforcement is enabled.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::SuccessResponse]
+      #
+      # @see Telnyx::Models::BotSignupCreateParams
+      def create(params)
+        parsed, options = Telnyx::BotSignupCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v2/bot_signup",
+          body: parsed,
+          model: Telnyx::SuccessResponse,
+          options: 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.
+      #
+      # @overload resend_magic_link(email:, request_options: {})
+      #
+      # @param email [String] Email address of the bot signup account to resend the magic link to.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::SuccessResponse]
+      #
+      # @see Telnyx::Models::BotSignupResendMagicLinkParams
+      def resend_magic_link(params)
+        parsed, options = Telnyx::BotSignupResendMagicLinkParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v2/bot_signup/resend_magic_link",
+          body: parsed,
+          model: Telnyx::SuccessResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/telnyx/resources/calls/actions.rb

@@ -352,7 +352,7 @@ module Telnyx
         #
         # @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -485,7 +485,7 @@ module Telnyx
         #
         # @param valid_digits [String] A list of all digits accepted as valid.
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -947,7 +947,7 @@ module Telnyx
         #
         # @param target_legs [Symbol, Telnyx::Models::Calls::ActionSpeakParams::TargetLegs] Specifies which legs of the call should receive the spoken audio.
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -1076,7 +1076,7 @@ module Telnyx
         #
         # @param voice [String] The voice to be used by the voice assistant. Currently we support ElevenLabs, Te
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -1836,7 +1836,7 @@ module Telnyx
         #
         # @param custom_headers [Array<Telnyx::Models::CustomSipHeader>] Custom headers to be added to the SIP INVITE.
         #
-        # @param diversion [String] The number the inbound call being transferred was originally received on, in +E1
+        # @param diversion [String] The `to` number of an active inbound call, in +E164 format. Telnyx checks whethe
         #
         # @param early_media [Boolean] If set to false, early media will not be passed to the originating leg.
         #

data/lib/telnyx/resources/calls.rb

@@ -71,7 +71,7 @@ module Telnyx
       #
       # @param dialogflow_config [Telnyx::Models::DialogflowConfig]
       #
-      # @param diversion [String] The number the inbound call being transferred was originally received on, in +E1
+      # @param diversion [String] The `to` number of an active inbound call, in +E164 format. Telnyx checks whethe
       #
       # @param enable_dialogflow [Boolean] Enables Dialogflow for the current call. The default value is false.
       #

data/lib/telnyx/resources/compute/funcs/export.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class Compute
+      class Funcs
+        class Export
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::Compute::Funcs::ExportCreateParams} for more details.
+          #
+          # 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.
+          #
+          # @overload create(id, endpoint:, headers:, invocation_export_enabled:, runtime_export_enabled:, request_options: {})
+          #
+          # @param id [String] Function ID
+          #
+          # @param endpoint [String] HTTPS URL to push logs to
+          #
+          # @param headers [Hash{Symbol=>String}] Headers attached to every export push, as key-value pairs (e.g. an auth token th
+          #
+          # @param invocation_export_enabled [Boolean] Export invocation records (one per HTTP request) to this destination
+          #
+          # @param runtime_export_enabled [Boolean] Export runtime logs (function stdout/stderr) to this destination
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Compute::Funcs::FuncLogExportConfigResponse]
+          #
+          # @see Telnyx::Models::Compute::Funcs::ExportCreateParams
+          def create(id, params)
+            parsed, options = Telnyx::Compute::Funcs::ExportCreateParams.dump_request(params)
+            @client.request(
+              method: :put,
+              path: ["compute/funcs/%1$s/logs/export", id],
+              body: parsed,
+              model: Telnyx::Compute::Funcs::FuncLogExportConfigResponse,
+              options: 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.
+          #
+          # @overload list(id, request_options: {})
+          #
+          # @param id [String] Function ID
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::Compute::Funcs::FuncLogExportConfigResponse]
+          #
+          # @see Telnyx::Models::Compute::Funcs::ExportListParams
+          def list(id, params = {})
+            @client.request(
+              method: :get,
+              path: ["compute/funcs/%1$s/logs/export", id],
+              model: Telnyx::Compute::Funcs::FuncLogExportConfigResponse,
+              options: params[:request_options]
+            )
+          end
+
+          # Stops exporting a function's logs and removes its destination configuration.
+          # Idempotent: deleting when nothing is configured succeeds.
+          #
+          # @overload delete_all(id, request_options: {})
+          #
+          # @param id [String] Function ID
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Telnyx::Models::Compute::Funcs::ExportDeleteAllParams
+          def delete_all(id, params = {})
+            @client.request(
+              method: :delete,
+              path: ["compute/funcs/%1$s/logs/export", id],
+              model: NilClass,
+              options: params[:request_options]
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/compute/funcs.rb

@@ -4,6 +4,9 @@ module Telnyx
   module Resources
     class Compute
       class Funcs
+        # @return [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.
@@ -134,6 +137,7 @@ module Telnyx
         # @param client [Telnyx::Client]
         def initialize(client:)
           @client = client
+          @export = Telnyx::Resources::Compute::Funcs::Export.new(client: client)
         end
       end
     end

data/lib/telnyx/resources/conferences/actions.rb

@@ -522,7 +522,7 @@ module Telnyx
         #
         # @param region [Symbol, Telnyx::Models::Conferences::ConferenceRegion] Region where the conference data is located. Defaults to the region defined in u
         #
-        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings] The settings associated with the voice selected
+        # @param voice_settings [Telnyx::Models::Calls::ElevenLabsVoiceSettings, Telnyx::Models::Calls::TelnyxVoiceSettings, Telnyx::Models::Calls::AwsVoiceSettings, Telnyx::Models::MinimaxVoiceSettings, Telnyx::Models::AzureVoiceSettings, Telnyx::Models::ResembleVoiceSettings, Telnyx::Models::InworldVoiceSettings, Telnyx::Models::XaiVoiceSettings, Telnyx::Models::Calls::SonioxVoiceSettings] The settings associated with the voice selected
         #
         # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/telnyx/resources/connections.rb

@@ -88,6 +88,26 @@ 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.
+      #
+      # @overload retrieve_count(request_options: {})
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::ConnectionRetrieveCountResponse]
+      #
+      # @see Telnyx::Models::ConnectionRetrieveCountParams
+      def retrieve_count(params = {})
+        @client.request(
+          method: :get,
+          path: "connections/count",
+          model: Telnyx::Models::ConnectionRetrieveCountResponse,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [Telnyx::Client]

data/lib/telnyx/resources/detail_records.rb

@@ -17,7 +17,7 @@ module Telnyx
       #
       # @param page_size [Integer]
       #
-      # @param sort [Array<String>] Specifies the sort order for results. <br/>Example: sort=-created_at
+      # @param sort [Array<String>] Specifies the sort order for results. <br/>Example: sort=-created_at <br/>The va
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/telnyx/resources/email_blocks/imports.rb

@@ -16,9 +16,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`).
         #
         # @overload create(file:, block_ttl_days: nil, request_options: {})
         #

data/lib/telnyx/resources/email_blocks.rb

@@ -194,9 +194,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).
       #
       # @overload retrieve_export(filter_created_after: nil, filter_created_before: nil, filter_domain_id: nil, filter_reason: nil, page_number: nil, page_size: nil, sort: nil, request_options: {})
       #

data/lib/telnyx/resources/email_domains.rb

@@ -221,6 +221,34 @@ 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.
+      #
+      # @overload rotate_dkim(domain_id, request_options: {})
+      #
+      # @param domain_id [String] Email domain UUID
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::EmailDomainRotateDkimResponse]
+      #
+      # @see Telnyx::Models::EmailDomainRotateDkimParams
+      def rotate_dkim(domain_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["email_domains/%1$s/rotate_dkim", domain_id],
+          model: Telnyx::Models::EmailDomainRotateDkimResponse,
+          options: params[:request_options]
+        )
+      end
+
       # Checks the published DNS records against the records required for the email
       # domain and returns the latest verification results.
       #

data/lib/telnyx/resources/email_events.rb

@@ -8,25 +8,38 @@ module Telnyx
       # {Telnyx::Models::EmailEventListParams} for more details.
       #
       # Lists account-level email events sorted oldest first by
-      # `occurred_at asc, id asc`.
-      #
-      # @overload list(email_id: nil, event_type: nil, from: nil, page_cursor: nil, page_size: nil, to: nil, request_options: {})
+      # `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.
+      #
+      # @overload list(email_id: nil, event_type: nil, from: nil, page_size: nil, page_cursor: nil, to: nil, request_options: {})
       #
       # @param email_id [String] Filter events for a specific email message UUID. Invalid UUID values are silentl
       #
-      # @param event_type [String, Array<String>] Comma-separated list of event types to include. Also accepts repeated query para
+      # @param event_type [String, Array<String>] Comma-separated list of event types to include. Also accepts repeated
       #
       # @param from [Time] Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.
       #
-      # @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous list response.
-      #
       # @param page_size [Integer] Number of results to return. Defaults to 25; maximum is 100. Invalid values are
       #
+      # @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous event list response. The le
+      #
       # @param to [Time] Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Internal::EmailCursorPagination<Telnyx::Models::EmailEventListResponse>]
+      # @return [Telnyx::Models::EmailEventListResponse]
       #
       # @see Telnyx::Models::EmailEventListParams
       def list(params = {})
@@ -35,8 +48,7 @@ module Telnyx
         @client.request(
           method: :get,
           path: "email_events",
-          query: query,
-          page: Telnyx::Internal::EmailCursorPagination,
+          query: query.transform_keys(page_cursor: "page[cursor]"),
           model: Telnyx::Models::EmailEventListResponse,
           options: options
         )

data/lib/telnyx/resources/email_messages.rb

@@ -50,21 +50,21 @@ module Telnyx
       #
       # @param inline_css [Boolean] Body param
       #
-      # @param metadata [Hash{Symbol=>Object}] Body param: Custom metadata. Write-only; not returned in responses.
+      # @param metadata [Hash{Symbol=>Object}] Body param: Custom metadata key/value pairs. Stored on the message, returned on
       #
       # @param reply_to [String, Telnyx::Models::EmailInboxes::EmailAddress] Body param: Reply-to address. If provided as an object with a name, only the ema
       #
       # @param reply_to_all [Boolean, nil] Body param: Indicates a reply-all intent. In Phase 1 (wire-only) this does not
       #
-      # @param sandbox_mode [Boolean] Body param
+      # @param sandbox_mode [Boolean] Body param: Validates and accepts the message without injecting it into the MTA
       #
-      # @param scheduled_at [Time, nil] Body param: Future ISO 8601 time to schedule sending. Invalid or past timestamps
+      # @param scheduled_at [Time, nil] Body param: Future ISO 8601 delivery time. Invalid or non-future timestamps are
       #
       # @param send_at [Time] Body param: Deprecated alias for `scheduled_at`.
       #
       # @param subject [String] Body param: Required unless `template_id` is supplied. When using a template, th
       #
-      # @param tags [Array<String>] Body param: Tags for categorization and reporting. Stored on the message and pro
+      # @param tags [Array<String>] Body param: Tags for categorization and filtering. Stored on the message, return
       #
       # @param template_id [String] Body param
       #
@@ -103,14 +103,14 @@ module Telnyx
       #
       # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Telnyx::Models::EmailMessageRetrieveResponse]
+      # @return [Telnyx::Models::EmailMessageDetailResponse]
       #
       # @see Telnyx::Models::EmailMessageRetrieveParams
       def retrieve(id, params = {})
         @client.request(
           method: :get,
           path: ["email_messages/%1$s", id],
-          model: Telnyx::Models::EmailMessageRetrieveResponse,
+          model: Telnyx::EmailMessageDetailResponse,
           options: params[:request_options]
         )
       end
@@ -118,11 +118,15 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::EmailMessageListParams} for more details.
       #
-      # Lists messages sorted newest first by `created_at desc, id desc`. No filters
-      # other than cursor pagination are implemented. The legacy `/v2/emails` GET route
-      # is a backward-compatible alias for this operation.
+      # Lists messages sorted newest first by `created_at desc, id desc`. Tags and
+      # metadata filters compose with cursor pagination. The legacy `/v2/emails` GET
+      # route is a backward-compatible alias for this operation.
       #
-      # @overload list(page_cursor: nil, page_size: nil, request_options: {})
+      # @overload list(filter_metadata: nil, filter_tags: nil, page_cursor: nil, page_size: nil, request_options: {})
+      #
+      # @param filter_metadata [String] Metadata containment filter, supplied as a JSON object or comma-separated `key=v
+      #
+      # @param filter_tags [String] Comma-separated tags. Each segment is trimmed, and messages having at least one
       #
       # @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous list response.
       #
@@ -139,7 +143,7 @@ module Telnyx
         @client.request(
           method: :get,
           path: "email_messages",
-          query: query,
+          query: query.transform_keys(filter_metadata: "filter[metadata]", filter_tags: "filter[tags]"),
           page: Telnyx::Internal::EmailCursorPagination,
           model: Telnyx::EmailInboxes::EmailMessage,
           options: options
@@ -172,15 +176,20 @@ module Telnyx
       # Some parameter documentations has been truncated, see
       # {Telnyx::Models::EmailMessageBatchParams} for more details.
       #
-      # Creates up to 1,000 email messages in a single request. Each message is
-      # validated and sent independently; per-message failures do not affect other
-      # messages in the batch. All responses use 207 Multi-Status.
+      # Creates up to 1,000 email messages in a single request. Request-wide admission
+      # checks run first and can reject the whole batch before message creation. After
+      # those checks pass, each message is validated and sent independently; item-level
+      # failures do not affect other messages, and the processed batch returns 207
+      # Multi-Status. Per-message failures include validation errors; when a template
+      # has `strict_variables` enabled, a missing required variable produces a per-item
+      # `unprocessable_entity` error naming that variable while the other messages
+      # continue.
       #
       # @overload batch(messages:, sandbox_mode: nil, idempotency_key: nil, request_options: {})
       #
       # @param messages [Array<Telnyx::Models::EmailMessageBatchParams::Message>] Body param: Array of email messages to send. Up to 1,000 messages per batch requ
       #
-      # @param sandbox_mode [Boolean] Body param: Applies sandbox mode to all messages in the batch. Overrides any per
+      # @param sandbox_mode [Boolean] Body param: Applies sandbox mode to all messages in the batch and overrides any
       #
       # @param idempotency_key [String] Header param: Optional opaque, unquoted key for safely retrying the same logical
       #
@@ -260,6 +269,15 @@ module Telnyx
       # `occurred_at asc, id asc`. The legacy `/v2/emails/{id}/events` GET route is a
       # backward-compatible alias.
       #
+      # For compatibility, each event carries the legacy customer-visible `event_type`
+      # (`email.`-prefixed), the additive `canonical_event_type` (`email.`-prefixed),
+      # and the deprecated `type` duplicate — whose value keeps the exact legacy format:
+      # the bare stored event name, never `email.`-prefixed. Gateway rejections render
+      # `email.failed` + canonical `email.gw_reject`; MTA expirations render
+      # `email.bounced` + canonical `email.expired`; every unchanged outcome carries
+      # identical `event_type` and `canonical_event_type` values (and `type` keeps the
+      # stored name).
+      #
       # @overload retrieve_events(email_id, page_cursor: nil, page_size: nil, request_options: {})
       #
       # @param email_id [String] Email message UUID.
@@ -286,6 +304,34 @@ module Telnyx
         )
       end
 
+      # Moves an existing scheduled email to a new future send time. Only the delivery
+      # time (`scheduled_at`) changes; the message ID, content, recipients, tags, and
+      # metadata remain unchanged. Returns `409 Conflict` if the message is no longer
+      # scheduled or its scheduled-send worker has already started processing it. This
+      # route emits no dedicated `rescheduled` event.
+      #
+      # @overload update_schedule(email_id, scheduled_at:, request_options: {})
+      #
+      # @param email_id [String] Email message UUID.
+      #
+      # @param scheduled_at [Time] New ISO 8601 delivery time. Must be strictly in the future.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Telnyx::Models::EmailMessageDetailResponse]
+      #
+      # @see Telnyx::Models::EmailMessageUpdateScheduleParams
+      def update_schedule(email_id, params)
+        parsed, options = Telnyx::EmailMessageUpdateScheduleParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["email_messages/%1$s/schedule", email_id],
+          body: parsed,
+          model: Telnyx::EmailMessageDetailResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Telnyx::Client]