telnyx 5.168.0 → 5.170.0

data/rbi/telnyx/models/email_event_type.rbi

@@ -2,6 +2,12 @@
 
 module Telnyx
   module Models
+    # Bare stored event names returned by message history. In addition to the normal
+    # send and delivery lifecycle, polling can expose suppression, scan, and
+    # quarantine lifecycle rows. Sharp canonical names gw_reject, injection_timeout,
+    # and expired distinguish gateway rejection, ambiguous injection timeout, and MTA
+    # expiration. The failed and bounced names remain valid for system/admin failures
+    # and hard bounces respectively. Existing stored rows retain their original names.
     module EmailEventType
       extend Telnyx::Internal::Type::Enum
 
@@ -19,12 +25,31 @@ module Telnyx
       DELIVERED = T.let(:delivered, Telnyx::EmailEventType::TaggedSymbol)
       BOUNCED = T.let(:bounced, Telnyx::EmailEventType::TaggedSymbol)
       COMPLAINED = T.let(:complained, Telnyx::EmailEventType::TaggedSymbol)
+      SUPPRESSED = T.let(:suppressed, Telnyx::EmailEventType::TaggedSymbol)
       REJECTED = T.let(:rejected, Telnyx::EmailEventType::TaggedSymbol)
       OPENED = T.let(:opened, Telnyx::EmailEventType::TaggedSymbol)
       CLICKED = T.let(:clicked, Telnyx::EmailEventType::TaggedSymbol)
       UNSUBSCRIBED = T.let(:unsubscribed, Telnyx::EmailEventType::TaggedSymbol)
       DAILY_LIMIT_EXCEEDED =
         T.let(:daily_limit_exceeded, Telnyx::EmailEventType::TaggedSymbol)
+      SCAN_DEFERRED =
+        T.let(:scan_deferred, Telnyx::EmailEventType::TaggedSymbol)
+      QUARANTINED = T.let(:quarantined, Telnyx::EmailEventType::TaggedSymbol)
+      QUARANTINE_RELEASED =
+        T.let(:quarantine_released, Telnyx::EmailEventType::TaggedSymbol)
+      QUARANTINE_RELEASE_DISPATCHED =
+        T.let(
+          :quarantine_release_dispatched,
+          Telnyx::EmailEventType::TaggedSymbol
+        )
+      QUARANTINE_REJECTED =
+        T.let(:quarantine_rejected, Telnyx::EmailEventType::TaggedSymbol)
+      QUARANTINE_EXPIRED =
+        T.let(:quarantine_expired, Telnyx::EmailEventType::TaggedSymbol)
+      GW_REJECT = T.let(:gw_reject, Telnyx::EmailEventType::TaggedSymbol)
+      INJECTION_TIMEOUT =
+        T.let(:injection_timeout, Telnyx::EmailEventType::TaggedSymbol)
+      EXPIRED = T.let(:expired, Telnyx::EmailEventType::TaggedSymbol)
 
       sig { override.returns(T::Array[Telnyx::EmailEventType::TaggedSymbol]) }
       def self.values

data/rbi/telnyx/models/email_inboxes/email_message.rbi

@@ -26,7 +26,7 @@ module Telnyx
         sig { returns(Time) }
         attr_accessor :created_at
 
-        sig { returns(T::Array[Telnyx::MessageEvent]) }
+        sig { returns(T::Array[Telnyx::EmailInboxes::EmailMessage::Event]) }
         attr_accessor :events
 
         sig { returns(Telnyx::EmailInboxes::EmailAddress) }
@@ -35,6 +35,10 @@ module Telnyx
         sig { params(from: Telnyx::EmailInboxes::EmailAddress::OrHash).void }
         attr_writer :from
 
+        # Customer-supplied metadata stored with the message.
+        sig { returns(T::Hash[Symbol, T.anything]) }
+        attr_accessor :metadata
+
         sig do
           returns(Telnyx::EmailInboxes::EmailMessage::RecordType::TaggedSymbol)
         end
@@ -54,6 +58,10 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :subject
 
+        # Customer-supplied tags stored with the message.
+        sig { returns(T::Array[String]) }
+        attr_accessor :tags
+
         sig { returns(T.nilable(String)) }
         attr_accessor :template_id
 
@@ -115,13 +123,15 @@ module Telnyx
             bcc: T::Array[Telnyx::EmailInboxes::EmailAddress::OrHash],
             cc: T::Array[Telnyx::EmailInboxes::EmailAddress::OrHash],
             created_at: Time,
-            events: T::Array[Telnyx::MessageEvent::OrHash],
+            events: T::Array[Telnyx::EmailInboxes::EmailMessage::Event::OrHash],
             from: Telnyx::EmailInboxes::EmailAddress::OrHash,
+            metadata: T::Hash[Symbol, T.anything],
             record_type:
               Telnyx::EmailInboxes::EmailMessage::RecordType::OrSymbol,
             reply_to: T.nilable(String),
             status: Telnyx::EmailInboxes::EmailMessage::Status::OrSymbol,
             subject: String,
+            tags: T::Array[String],
             template_id: T.nilable(String),
             template_variables: T::Hash[Symbol, T.anything],
             to: T::Array[Telnyx::EmailInboxes::EmailAddress::OrHash],
@@ -140,6 +150,8 @@ module Telnyx
           created_at:,
           events:,
           from:,
+          # Customer-supplied metadata stored with the message.
+          metadata:,
           record_type:,
           reply_to:,
           # Current status of an email message. Lifecycle statuses (queued, scheduled, etc.)
@@ -147,6 +159,8 @@ module Telnyx
           # delivery event consumers.
           status:,
           subject:,
+          # Customer-supplied tags stored with the message.
+          tags:,
           template_id:,
           template_variables:,
           to:,
@@ -179,13 +193,15 @@ module Telnyx
               bcc: T::Array[Telnyx::EmailInboxes::EmailAddress],
               cc: T::Array[Telnyx::EmailInboxes::EmailAddress],
               created_at: Time,
-              events: T::Array[Telnyx::MessageEvent],
+              events: T::Array[Telnyx::EmailInboxes::EmailMessage::Event],
               from: Telnyx::EmailInboxes::EmailAddress,
+              metadata: T::Hash[Symbol, T.anything],
               record_type:
                 Telnyx::EmailInboxes::EmailMessage::RecordType::TaggedSymbol,
               reply_to: T.nilable(String),
               status: Telnyx::EmailInboxes::EmailMessage::Status::TaggedSymbol,
               subject: String,
+              tags: T::Array[String],
               template_id: T.nilable(String),
               template_variables: T::Hash[Symbol, T.anything],
               to: T::Array[Telnyx::EmailInboxes::EmailAddress],
@@ -282,6 +298,68 @@ module Telnyx
           end
         end
 
+        class Event < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::EmailInboxes::EmailMessage::Event,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Time) }
+          attr_accessor :occurred_at
+
+          # Bare stored event names returned by message history. In addition to the normal
+          # send and delivery lifecycle, polling can expose suppression, scan, and
+          # quarantine lifecycle rows. Sharp canonical names gw_reject, injection_timeout,
+          # and expired distinguish gateway rejection, ambiguous injection timeout, and MTA
+          # expiration. The failed and bounced names remain valid for system/admin failures
+          # and hard bounces respectively. Existing stored rows retain their original names.
+          sig { returns(Telnyx::EmailEventType::TaggedSymbol) }
+          attr_accessor :type
+
+          sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+          attr_reader :payload
+
+          sig { params(payload: T::Hash[Symbol, T.anything]).void }
+          attr_writer :payload
+
+          # An event embedded in a message response. The dedicated per-message events
+          # endpoint additionally returns event_type and canonical_event_type.
+          sig do
+            params(
+              occurred_at: Time,
+              type: Telnyx::EmailEventType::OrSymbol,
+              payload: T::Hash[Symbol, T.anything]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            occurred_at:,
+            # Bare stored event names returned by message history. In addition to the normal
+            # send and delivery lifecycle, polling can expose suppression, scan, and
+            # quarantine lifecycle rows. Sharp canonical names gw_reject, injection_timeout,
+            # and expired distinguish gateway rejection, ambiguous injection timeout, and MTA
+            # expiration. The failed and bounced names remain valid for system/admin failures
+            # and hard bounces respectively. Existing stored rows retain their original names.
+            type:,
+            payload: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                occurred_at: Time,
+                type: Telnyx::EmailEventType::TaggedSymbol,
+                payload: T::Hash[Symbol, T.anything]
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
         module RecordType
           extend Telnyx::Internal::Type::Enum
 

data/rbi/telnyx/models/email_message_batch_params.rbi

@@ -17,8 +17,13 @@ module Telnyx
       sig { returns(T::Array[Telnyx::EmailMessageBatchParams::Message]) }
       attr_accessor :messages
 
-      # Applies sandbox mode to all messages in the batch. Overrides any per-message
-      # sandbox_mode in the messages array.
+      # Applies sandbox mode to all messages in the batch and overrides any per-message
+      # `sandbox_mode` value — each message's effective `sandbox_mode` is exactly this
+      # envelope value. Reserved recipients at `test.telnyx.com` produce the
+      # deterministic event chains documented on CreateEmailRequest.sandbox_mode; no
+      # batch item is injected into the MTA or outbound Kafka path. Sandbox batch items
+      # are non-billable, consume no daily-send-limit quota, and feed no
+      # delivery-reputation signals.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :sandbox_mode
 
@@ -44,8 +49,13 @@ module Telnyx
         # message is validated and sent independently; per-message failures do not affect
         # other messages in the batch.
         messages:,
-        # Applies sandbox mode to all messages in the batch. Overrides any per-message
-        # sandbox_mode in the messages array.
+        # Applies sandbox mode to all messages in the batch and overrides any per-message
+        # `sandbox_mode` value — each message's effective `sandbox_mode` is exactly this
+        # envelope value. Reserved recipients at `test.telnyx.com` produce the
+        # deterministic event chains documented on CreateEmailRequest.sandbox_mode; no
+        # batch item is injected into the MTA or outbound Kafka path. Sandbox batch items
+        # are non-billable, consume no daily-send-limit quota, and feed no
+        # delivery-reputation signals.
         sandbox_mode: nil,
         idempotency_key: nil,
         request_options: {}
@@ -170,7 +180,9 @@ module Telnyx
         sig { params(inline_css: T::Boolean).void }
         attr_writer :inline_css
 
-        # Custom metadata. Write-only; not returned in responses.
+        # Custom metadata key/value pairs. Stored on the message, returned on message
+        # responses, and propagated to Email Detail Records. Usable in `filter[metadata]`
+        # when listing messages.
         sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
         attr_reader :metadata
 
@@ -191,16 +203,22 @@ module Telnyx
         end
         attr_writer :reply_to
 
+        # Per-message sandbox flag. The batch-level `sandbox_mode` envelope value is
+        # authoritative: it overwrites every message's `sandbox_mode` before processing,
+        # including the `false` default when the envelope omits the field. A per-item
+        # `sandbox_mode: true` inside a non-sandbox batch is therefore a real send. Set
+        # the envelope field to run any batch item in sandbox mode.
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :sandbox_mode
 
         sig { params(sandbox_mode: T::Boolean).void }
         attr_writer :sandbox_mode
 
-        # Future ISO 8601 time to schedule sending. Invalid or past timestamps are
-        # silently ignored and the email is sent immediately. The legacy alias `send_at`
-        # is still accepted for backward compatibility; when both are provided,
-        # `scheduled_at` wins.
+        # Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected.
+        # Single sends return HTTP 422; in batch sends the invalid item is reported in the
+        # 207 per-item errors while other items continue. `send_at` remains a deprecated
+        # request alias. A non-null `scheduled_at` takes precedence over `send_at`; when
+        # `scheduled_at` is omitted or null, `send_at` is used.
         sig { returns(T.nilable(Time)) }
         attr_accessor :scheduled_at
 
@@ -220,8 +238,9 @@ module Telnyx
         sig { params(subject: String).void }
         attr_writer :subject
 
-        # Tags for categorization and reporting. Stored on the message and propagated to
-        # Email Detail Records. Not returned in API responses.
+        # Tags for categorization and filtering. Stored on the message, returned on
+        # message responses, and propagated to Email Detail Records. Usable in
+        # `filter[tags]` when listing messages.
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :tags
 
@@ -236,7 +255,10 @@ module Telnyx
 
         # Variables for Liquid template rendering. Non-object values may cause a 422
         # validation error on message creation, but are silently treated as an empty
-        # object for template rendering.
+        # object for template rendering. When the template enables `strict_variables`, a
+        # missing required variable fails the request with 422 (single send) or a per-item
+        # `unprocessable_entity` error (batch) naming the variable; no message is
+        # persisted for the failed item.
         sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
         attr_reader :template_variables
 
@@ -322,16 +344,24 @@ module Telnyx
           # be overridden. Requires the `email:override` API scope.
           ignore_suppression: nil,
           inline_css: nil,
-          # Custom metadata. Write-only; not returned in responses.
+          # Custom metadata key/value pairs. Stored on the message, returned on message
+          # responses, and propagated to Email Detail Records. Usable in `filter[metadata]`
+          # when listing messages.
           metadata: nil,
           # Reply-to address. If provided as an object with a name, only the email is
           # stored; the name is ignored.
           reply_to: nil,
+          # Per-message sandbox flag. The batch-level `sandbox_mode` envelope value is
+          # authoritative: it overwrites every message's `sandbox_mode` before processing,
+          # including the `false` default when the envelope omits the field. A per-item
+          # `sandbox_mode: true` inside a non-sandbox batch is therefore a real send. Set
+          # the envelope field to run any batch item in sandbox mode.
           sandbox_mode: nil,
-          # Future ISO 8601 time to schedule sending. Invalid or past timestamps are
-          # silently ignored and the email is sent immediately. The legacy alias `send_at`
-          # is still accepted for backward compatibility; when both are provided,
-          # `scheduled_at` wins.
+          # Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected.
+          # Single sends return HTTP 422; in batch sends the invalid item is reported in the
+          # 207 per-item errors while other items continue. `send_at` remains a deprecated
+          # request alias. A non-null `scheduled_at` takes precedence over `send_at`; when
+          # `scheduled_at` is omitted or null, `send_at` is used.
           scheduled_at: nil,
           # Deprecated alias for `scheduled_at`.
           send_at: nil,
@@ -339,13 +369,17 @@ module Telnyx
           # subject is rendered; if the template has no subject or renders empty, the
           # request returns 400.
           subject: nil,
-          # Tags for categorization and reporting. Stored on the message and propagated to
-          # Email Detail Records. Not returned in API responses.
+          # Tags for categorization and filtering. Stored on the message, returned on
+          # message responses, and propagated to Email Detail Records. Usable in
+          # `filter[tags]` when listing messages.
           tags: nil,
           template_id: nil,
           # Variables for Liquid template rendering. Non-object values may cause a 422
           # validation error on message creation, but are silently treated as an empty
-          # object for template rendering.
+          # object for template rendering. When the template enables `strict_variables`, a
+          # missing required variable fails the request with 422 (single send) or a per-item
+          # `unprocessable_entity` error (batch) naming the variable; no message is
+          # persisted for the failed item.
           template_variables: nil,
           # Plain text email body. Returned only by `GET /email_messages/{id}`; omitted from
           # create and list responses.

data/rbi/telnyx/models/email_message_create_params.rbi

@@ -124,7 +124,9 @@ module Telnyx
       sig { params(inline_css: T::Boolean).void }
       attr_writer :inline_css
 
-      # Custom metadata. Write-only; not returned in responses.
+      # Custom metadata key/value pairs. Stored on the message, returned on message
+      # responses, and propagated to Email Detail Records. Usable in `filter[metadata]`
+      # when listing messages.
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :metadata
 
@@ -156,16 +158,42 @@ module Telnyx
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :reply_to_all
 
+      # Validates and accepts the message without injecting it into the MTA or outbound
+      # Kafka path. Nothing is delivered: sandbox records are non-billable, consume no
+      # daily-send-limit quota, and feed no delivery-reputation signals.
+      #
+      # The reserved sandbox test-recipient domain is `test.telnyx.com`. In sandbox
+      # mode, these addresses produce deterministic recipient-scoped lifecycle events:
+      #
+      # - `delivered@test.telnyx.com`: queued -> sending -> sent -> delivered
+      # - `hard-bounce@test.telnyx.com`: queued -> sending -> sent -> bounced
+      #   (permanent)
+      # - `soft-bounce@test.telnyx.com`: queued -> sending -> sent -> bounced
+      #   (transient)
+      # - `complaint@test.telnyx.com`: queued -> sending -> sent -> complained
+      # - `suppressed@test.telnyx.com`: queued -> suppressed
+      # - `invalid@test.telnyx.com`: queued -> sending -> failed (invalid recipient)
+      # - `dkim-fail@test.telnyx.com`: queued -> sending -> failed (DKIM unavailable)
+      # - `rate-limit@test.telnyx.com`: queued -> sending -> failed (rate limit
+      #   exceeded)
+      #
+      # Matching is case-insensitive for both the local part and the domain and requires
+      # the exact domain `test.telnyx.com` — subdomains and other domains do not match.
+      # Mixed sandbox sends simulate only reserved test recipients; other recipients
+      # retain ordinary sandbox behavior (accepted, no delivery attempted). Hard-bounce
+      # and complaint outcomes also use the normal automatic-suppression pipeline.
+      # Non-sandbox sends to these addresses use the normal delivery path.
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :sandbox_mode
 
       sig { params(sandbox_mode: T::Boolean).void }
       attr_writer :sandbox_mode
 
-      # Future ISO 8601 time to schedule sending. Invalid or past timestamps are
-      # silently ignored and the email is sent immediately. The legacy alias `send_at`
-      # is still accepted for backward compatibility; when both are provided,
-      # `scheduled_at` wins.
+      # Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected.
+      # Single sends return HTTP 422; in batch sends the invalid item is reported in the
+      # 207 per-item errors while other items continue. `send_at` remains a deprecated
+      # request alias. A non-null `scheduled_at` takes precedence over `send_at`; when
+      # `scheduled_at` is omitted or null, `send_at` is used.
       sig { returns(T.nilable(Time)) }
       attr_accessor :scheduled_at
 
@@ -185,8 +213,9 @@ module Telnyx
       sig { params(subject: String).void }
       attr_writer :subject
 
-      # Tags for categorization and reporting. Stored on the message and propagated to
-      # Email Detail Records. Not returned in API responses.
+      # Tags for categorization and filtering. Stored on the message, returned on
+      # message responses, and propagated to Email Detail Records. Usable in
+      # `filter[tags]` when listing messages.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :tags
 
@@ -201,7 +230,10 @@ module Telnyx
 
       # Variables for Liquid template rendering. Non-object values may cause a 422
       # validation error on message creation, but are silently treated as an empty
-      # object for template rendering.
+      # object for template rendering. When the template enables `strict_variables`, a
+      # missing required variable fails the request with 422 (single send) or a per-item
+      # `unprocessable_entity` error (batch) naming the variable; no message is
+      # persisted for the failed item.
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :template_variables
 
@@ -306,7 +338,9 @@ module Telnyx
         # Cannot be combined with `forward_of_message_id` (422).
         in_reply_to_message_id: nil,
         inline_css: nil,
-        # Custom metadata. Write-only; not returned in responses.
+        # Custom metadata key/value pairs. Stored on the message, returned on message
+        # responses, and propagated to Email Detail Records. Usable in `filter[metadata]`
+        # when listing messages.
         metadata: nil,
         # Reply-to address. If provided as an object with a name, only the email is
         # stored; the name is ignored.
@@ -320,11 +354,37 @@ module Telnyx
         #
         # Only meaningful alongside `in_reply_to_message_id`.
         reply_to_all: nil,
+        # Validates and accepts the message without injecting it into the MTA or outbound
+        # Kafka path. Nothing is delivered: sandbox records are non-billable, consume no
+        # daily-send-limit quota, and feed no delivery-reputation signals.
+        #
+        # The reserved sandbox test-recipient domain is `test.telnyx.com`. In sandbox
+        # mode, these addresses produce deterministic recipient-scoped lifecycle events:
+        #
+        # - `delivered@test.telnyx.com`: queued -> sending -> sent -> delivered
+        # - `hard-bounce@test.telnyx.com`: queued -> sending -> sent -> bounced
+        #   (permanent)
+        # - `soft-bounce@test.telnyx.com`: queued -> sending -> sent -> bounced
+        #   (transient)
+        # - `complaint@test.telnyx.com`: queued -> sending -> sent -> complained
+        # - `suppressed@test.telnyx.com`: queued -> suppressed
+        # - `invalid@test.telnyx.com`: queued -> sending -> failed (invalid recipient)
+        # - `dkim-fail@test.telnyx.com`: queued -> sending -> failed (DKIM unavailable)
+        # - `rate-limit@test.telnyx.com`: queued -> sending -> failed (rate limit
+        #   exceeded)
+        #
+        # Matching is case-insensitive for both the local part and the domain and requires
+        # the exact domain `test.telnyx.com` — subdomains and other domains do not match.
+        # Mixed sandbox sends simulate only reserved test recipients; other recipients
+        # retain ordinary sandbox behavior (accepted, no delivery attempted). Hard-bounce
+        # and complaint outcomes also use the normal automatic-suppression pipeline.
+        # Non-sandbox sends to these addresses use the normal delivery path.
         sandbox_mode: nil,
-        # Future ISO 8601 time to schedule sending. Invalid or past timestamps are
-        # silently ignored and the email is sent immediately. The legacy alias `send_at`
-        # is still accepted for backward compatibility; when both are provided,
-        # `scheduled_at` wins.
+        # Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected.
+        # Single sends return HTTP 422; in batch sends the invalid item is reported in the
+        # 207 per-item errors while other items continue. `send_at` remains a deprecated
+        # request alias. A non-null `scheduled_at` takes precedence over `send_at`; when
+        # `scheduled_at` is omitted or null, `send_at` is used.
         scheduled_at: nil,
         # Deprecated alias for `scheduled_at`.
         send_at: nil,
@@ -332,13 +392,17 @@ module Telnyx
         # subject is rendered; if the template has no subject or renders empty, the
         # request returns 400.
         subject: nil,
-        # Tags for categorization and reporting. Stored on the message and propagated to
-        # Email Detail Records. Not returned in API responses.
+        # Tags for categorization and filtering. Stored on the message, returned on
+        # message responses, and propagated to Email Detail Records. Usable in
+        # `filter[tags]` when listing messages.
         tags: nil,
         template_id: nil,
         # Variables for Liquid template rendering. Non-object values may cause a 422
         # validation error on message creation, but are silently treated as an empty
-        # object for template rendering.
+        # object for template rendering. When the template enables `strict_variables`, a
+        # missing required variable fails the request with 422 (single send) or a per-item
+        # `unprocessable_entity` error (batch) naming the variable; no message is
+        # persisted for the failed item.
         template_variables: nil,
         # Plain text email body. Returned only by `GET /email_messages/{id}`; omitted from
         # create and list responses.

data/rbi/telnyx/models/{email_message_retrieve_response.rbi → email_message_detail_response.rbi}

@@ -2,37 +2,30 @@
 
 module Telnyx
   module Models
-    class EmailMessageRetrieveResponse < Telnyx::Internal::Type::BaseModel
+    class EmailMessageDetailResponse < Telnyx::Internal::Type::BaseModel
       OrHash =
         T.type_alias do
-          T.any(
-            Telnyx::Models::EmailMessageRetrieveResponse,
-            Telnyx::Internal::AnyHash
-          )
+          T.any(Telnyx::EmailMessageDetailResponse, Telnyx::Internal::AnyHash)
         end
 
-      sig { returns(Telnyx::Models::EmailMessageRetrieveResponse::Data) }
+      sig { returns(Telnyx::EmailMessageDetailResponse::Data) }
       attr_reader :data
 
       sig do
-        params(
-          data: Telnyx::Models::EmailMessageRetrieveResponse::Data::OrHash
-        ).void
+        params(data: Telnyx::EmailMessageDetailResponse::Data::OrHash).void
       end
       attr_writer :data
 
       sig do
-        params(
-          data: Telnyx::Models::EmailMessageRetrieveResponse::Data::OrHash
-        ).returns(T.attached_class)
+        params(data: Telnyx::EmailMessageDetailResponse::Data::OrHash).returns(
+          T.attached_class
+        )
       end
       def self.new(data:)
       end
 
       sig do
-        override.returns(
-          { data: Telnyx::Models::EmailMessageRetrieveResponse::Data }
-        )
+        override.returns({ data: Telnyx::EmailMessageDetailResponse::Data })
       end
       def to_hash
       end
@@ -41,7 +34,7 @@ module Telnyx
         OrHash =
           T.type_alias do
             T.any(
-              Telnyx::Models::EmailMessageRetrieveResponse::Data,
+              Telnyx::EmailMessageDetailResponse::Data,
               Telnyx::Internal::AnyHash
             )
           end

data/rbi/telnyx/models/email_message_list_params.rbi

@@ -11,6 +11,29 @@ module Telnyx
           T.any(Telnyx::EmailMessageListParams, Telnyx::Internal::AnyHash)
         end
 
+      # Metadata containment filter, supplied as a JSON object or comma-separated
+      # `key=value` pairs. All supplied key/value pairs must be contained in the message
+      # metadata. An empty value or empty JSON object omits the filter. Malformed
+      # values, valid non-object JSON, pairs without `=`, empty keys, and
+      # non-string/nested query shapes return HTTP 400.
+      sig { returns(T.nilable(String)) }
+      attr_reader :filter_metadata
+
+      sig { params(filter_metadata: String).void }
+      attr_writer :filter_metadata
+
+      # Comma-separated tags. Each segment is trimmed, and messages having at least one
+      # supplied tag are returned; matching is exact and case-sensitive after trimming.
+      # Because commas delimit values and surrounding whitespace is removed, this filter
+      # cannot represent stored tags containing literal commas or leading/trailing
+      # whitespace. An empty value omits the filter. Empty segments and
+      # non-string/nested query shapes return HTTP 400.
+      sig { returns(T.nilable(String)) }
+      attr_reader :filter_tags
+
+      sig { params(filter_tags: String).void }
+      attr_writer :filter_tags
+
       # Opaque URL-safe Base64 cursor returned by a previous list response.
       sig { returns(T.nilable(String)) }
       attr_reader :page_cursor
@@ -28,12 +51,27 @@ module Telnyx
 
       sig do
         params(
+          filter_metadata: String,
+          filter_tags: String,
           page_cursor: String,
           page_size: Integer,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # Metadata containment filter, supplied as a JSON object or comma-separated
+        # `key=value` pairs. All supplied key/value pairs must be contained in the message
+        # metadata. An empty value or empty JSON object omits the filter. Malformed
+        # values, valid non-object JSON, pairs without `=`, empty keys, and
+        # non-string/nested query shapes return HTTP 400.
+        filter_metadata: nil,
+        # Comma-separated tags. Each segment is trimmed, and messages having at least one
+        # supplied tag are returned; matching is exact and case-sensitive after trimming.
+        # Because commas delimit values and surrounding whitespace is removed, this filter
+        # cannot represent stored tags containing literal commas or leading/trailing
+        # whitespace. An empty value omits the filter. Empty segments and
+        # non-string/nested query shapes return HTTP 400.
+        filter_tags: 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
@@ -46,6 +84,8 @@ module Telnyx
       sig do
         override.returns(
           {
+            filter_metadata: String,
+            filter_tags: String,
             page_cursor: String,
             page_size: Integer,
             request_options: Telnyx::RequestOptions

data/rbi/telnyx/models/email_message_update_schedule_params.rbi

@@ -0,0 +1,52 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class EmailMessageUpdateScheduleParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::EmailMessageUpdateScheduleParams,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :email_id
+
+      # New ISO 8601 delivery time. Must be strictly in the future.
+      sig { returns(Time) }
+      attr_accessor :scheduled_at
+
+      sig do
+        params(
+          email_id: String,
+          scheduled_at: Time,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        email_id:,
+        # New ISO 8601 delivery time. Must be strictly in the future.
+        scheduled_at:,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            email_id: String,
+            scheduled_at: Time,
+            request_options: Telnyx::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end