telnyx 5.168.0 → 5.170.0

data/lib/telnyx/models/email_domains/email_webhook_event.rb

@@ -3,9 +3,11 @@
 module Telnyx
   module Models
     module EmailDomains
-      # Event types a webhook may subscribe to. The union of email._ events (published
-      # by email-api) and email_domain._ lifecycle events (published by this service).
-      # An event not listed here can never be subscribed to and is silently dropped.
+      # Event types accepted by domain webhook subscriptions. Allowlists match the
+      # legacy event_type, not canonical_event_type. Of the 22 accepted types,
+      # email.sending is stored but intentionally not published. Cancellation,
+      # daily-limit failures, and system failures publish after commit when a matching
+      # domain webhook is configured.
       module EmailWebhookEvent
         extend Telnyx::Internal::Type::Enum
 
@@ -23,11 +25,14 @@ module Telnyx
         EMAIL_CLICKED = :"email.clicked"
         EMAIL_UNSUBSCRIBED = :"email.unsubscribed"
         EMAIL_RECEIVED = :"email.received"
+        EMAIL_CANCELLED = :"email.cancelled"
+        EMAIL_DAILY_LIMIT_EXCEEDED = :"email.daily_limit_exceeded"
         EMAIL_DOMAIN_CREATED = :"email_domain.created"
         EMAIL_DOMAIN_VERIFIED = :"email_domain.verified"
         EMAIL_DOMAIN_DEGRADED = :"email_domain.degraded"
         EMAIL_DOMAIN_SUSPENDED = :"email_domain.suspended"
         EMAIL_DOMAIN_DELETED = :"email_domain.deleted"
+        EMAIL_DOMAIN_DKIM_ROTATED = :"email_domain.dkim_rotated"
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/telnyx/models/email_event_list_params.rb

@@ -19,6 +19,17 @@ module Telnyx
       #   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.
+      #
       #   @return [String, Array<String>, nil]
       optional :event_type, union: -> { Telnyx::EmailEventListParams::EventType }
 
@@ -28,12 +39,6 @@ module Telnyx
       #   @return [Time, nil]
       optional :from, Time
 
-      # @!attribute page_cursor
-      #   Opaque URL-safe Base64 cursor returned by a previous list response.
-      #
-      #   @return [String, nil]
-      optional :page_cursor, String
-
       # @!attribute page_size
       #   Number of results to return. Defaults to 25; maximum is 100. Invalid values are
       #   clamped to the valid range.
@@ -41,6 +46,13 @@ module Telnyx
       #   @return [Integer, nil]
       optional :page_size, Integer
 
+      # @!attribute page_cursor
+      #   Opaque URL-safe Base64 cursor returned by a previous event list response. The
+      #   legacy `page[after]` and flat `page_cursor` forms are also accepted.
+      #
+      #   @return [String, nil]
+      optional :page_cursor, String
+
       # @!attribute to
       #   Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
       #   to `from + 30 days`.
@@ -48,20 +60,20 @@ module Telnyx
       #   @return [Time, nil]
       optional :to, Time
 
-      # @!method initialize(email_id: nil, event_type: nil, from: nil, page_cursor: nil, page_size: nil, to: nil, request_options: {})
+      # @!method initialize(email_id: nil, event_type: nil, from: nil, page_size: nil, page_cursor: nil, to: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::EmailEventListParams} for more details.
       #
       #   @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}]
@@ -69,6 +81,17 @@ 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.
       module EventType
         extend Telnyx::Internal::Type::Union
 

data/lib/telnyx/models/email_event_list_response.rb

@@ -4,101 +4,328 @@ module Telnyx
   module Models
     # @see Telnyx::Resources::EmailEvents#list
     class EmailEventListResponse < Telnyx::Internal::Type::BaseModel
-      # @!attribute id
+      # @!attribute data
       #
-      #   @return [String]
-      required :id, String
+      #   @return [Array<Telnyx::Models::EmailEventListResponse::Data>]
+      required :data, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::EmailEventListResponse::Data] }
 
-      # @!attribute email_id
+      # @!attribute meta
       #
-      #   @return [String]
-      required :email_id, String
+      #   @return [Telnyx::Models::EmailEventListResponse::Meta]
+      required :meta, -> { Telnyx::Models::EmailEventListResponse::Meta }
 
-      # @!attribute occurred_at
-      #
-      #   @return [Time]
-      required :occurred_at, Time
+      # @!method initialize(data:, meta:)
+      #   @param data [Array<Telnyx::Models::EmailEventListResponse::Data>]
+      #   @param meta [Telnyx::Models::EmailEventListResponse::Meta]
 
-      # @!attribute record_type
-      #
-      #   @return [Symbol, Telnyx::Models::EmailEventListResponse::RecordType]
-      required :record_type, enum: -> { Telnyx::Models::EmailEventListResponse::RecordType }
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Event UUID.
+        #
+        #   @return [String]
+        required :id, String
 
-      # @!attribute type
-      #
-      #   @return [Symbol, Telnyx::Models::EmailEventType]
-      required :type, enum: -> { Telnyx::EmailEventType }
+        # @!attribute canonical_event_type
+        #   Additive canonical outcome name, prefixed with `email.`. Gateway rejection is
+        #   `email.gw_reject`, ambiguous injection timeout is `email.injection_timeout`, and
+        #   MTA expiration is `email.expired`. Unchanged outcomes retain their names.
+        #   Existing stored rows are translated only when recorded payload evidence proves
+        #   the outcome; a legacy failed row is not guessed or sharpened.
+        #
+        #   @return [String]
+        required :canonical_event_type, String
 
-      # @!attribute email
-      #   Summary of the associated email message. Present when the email_message preload
-      #   is available.
-      #
-      #   @return [Telnyx::Models::EmailEventListResponse::Email, nil]
-      optional :email, -> { Telnyx::Models::EmailEventListResponse::Email }
+        # @!attribute event_type
+        #   Legacy customer-visible event name, prefixed with `email.`. Gateway rejections
+        #   render `email.failed`; MTA expirations render `email.bounced`. Webhook
+        #   subscription allowlists match the legacy name.
+        #
+        #   @return [String]
+        required :event_type, String
 
-      # @!attribute payload
-      #
-      #   @return [Hash{Symbol=>Object}, nil]
-      optional :payload, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+        # @!attribute occurred_at
+        #
+        #   @return [Time]
+        required :occurred_at, Time
 
-      # @!method initialize(id:, email_id:, occurred_at:, record_type:, type:, email: nil, payload: nil)
-      #   Some parameter documentations has been truncated, see
-      #   {Telnyx::Models::EmailEventListResponse} for more details.
-      #
-      #   @param id [String]
-      #
-      #   @param email_id [String]
-      #
-      #   @param occurred_at [Time]
-      #
-      #   @param record_type [Symbol, Telnyx::Models::EmailEventListResponse::RecordType]
-      #
-      #   @param type [Symbol, Telnyx::Models::EmailEventType]
-      #
-      #   @param email [Telnyx::Models::EmailEventListResponse::Email] Summary of the associated email message. Present when the email_message preload
-      #
-      #   @param payload [Hash{Symbol=>Object}]
+        # @!attribute payload
+        #   Payload returned by GET /email_events. Every row includes id, status, and
+        #   occurred_at. Recipient-scoped rows also include recipient_id, from, subject, and
+        #   exactly one object-valued to, cc, or bcc field. Legacy or message-scoped rows
+        #   can omit recipient_id and use object-valued or string-valued to/cc fields,
+        #   including an empty string when no address exists; bcc is redacted. If the
+        #   related message or recipient cannot be loaded, the minimal fallback can omit
+        #   from, subject, and recipient fields. Additional persisted public evidence can be
+        #   present.
+        #
+        #   @return [Telnyx::Models::EmailEventListResponse::Data::Payload]
+        required :payload, -> { Telnyx::Models::EmailEventListResponse::Data::Payload }
+
+        # @!attribute recipient_id
+        #   Durable email recipient UUID. Present for recipient-scoped events, including
+        #   each queued, sending, sandbox, cancelled, and daily_limit_exceeded fan-out
+        #   event.
+        #
+        #   @return [String, nil]
+        optional :recipient_id, String
+
+        # @!method initialize(id:, canonical_event_type:, event_type:, occurred_at:, payload:, recipient_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::EmailEventListResponse::Data} for more details.
+        #
+        #   An account-polling event. The envelope is webhook-shaped, but polling preserves
+        #   stored-event cardinality: queued, sending, sandbox, cancelled, and
+        #   daily_limit_exceeded message events fan out per recipient; scheduled remains one
+        #   message-scoped row. Payload fields vary among recipient-scoped, message-scoped,
+        #   and minimal fallback rows.
+        #
+        #   @param id [String] Event UUID.
+        #
+        #   @param canonical_event_type [String] Additive canonical outcome name, prefixed with `email.`. Gateway rejection is `e
+        #
+        #   @param event_type [String] Legacy customer-visible event name, prefixed with `email.`. Gateway rejections r
+        #
+        #   @param occurred_at [Time]
+        #
+        #   @param payload [Telnyx::Models::EmailEventListResponse::Data::Payload] Payload returned by GET /email_events. Every row includes id, status, and occurr
+        #
+        #   @param recipient_id [String] Durable email recipient UUID. Present for recipient-scoped events, including eac
+
+        # @see Telnyx::Models::EmailEventListResponse::Data#payload
+        class Payload < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #   Email message UUID.
+          #
+          #   @return [String]
+          required :id, String
 
-      # @see Telnyx::Models::EmailEventListResponse#record_type
-      module RecordType
-        extend Telnyx::Internal::Type::Enum
+          # @!attribute occurred_at
+          #
+          #   @return [Time]
+          required :occurred_at, Time
 
-        EMAIL_EVENT = :email_event
+          # @!attribute status
+          #   Stored event outcome slug, not the authoritative recipient status. Account
+          #   polling returns the stored name, including suppression, scan, and quarantine
+          #   lifecycle names. Webhooks retain legacy payload names: gateway rejections use
+          #   failed and MTA expirations use bounced. New sharp stored rows can expose
+          #   gw_reject, injection_timeout, or expired. Use the envelope canonical_event_type
+          #   to identify the outcome across surfaces.
+          #
+          #   @return [Symbol, Telnyx::Models::EmailEventListResponse::Data::Payload::Status]
+          required :status, enum: -> { Telnyx::Models::EmailEventListResponse::Data::Payload::Status }
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+          # @!attribute bcc
+          #
+          #   @return [Telnyx::Models::EmailWebhookRecipient, Symbol, Telnyx::Models::EmailEventListResponse::Data::Payload::Bcc, nil]
+          optional :bcc, union: -> { Telnyx::Models::EmailEventListResponse::Data::Payload::Bcc }
+
+          # @!attribute cc
+          #   Legacy message-scoped address, or an empty string when absent.
+          #
+          #   @return [Telnyx::Models::EmailWebhookRecipient, String, nil]
+          optional :cc, union: -> { Telnyx::Models::EmailEventListResponse::Data::Payload::Cc }
+
+          # @!attribute from
+          #   Sender projection in account event polling. The display name is explicitly null
+          #   when the message has no sender name.
+          #
+          #   @return [Telnyx::Models::EmailEventListResponse::Data::Payload::From, nil]
+          optional :from, -> { Telnyx::Models::EmailEventListResponse::Data::Payload::From }
+
+          # @!attribute recipient_id
+          #   Durable email recipient UUID. Present for recipient-scoped events.
+          #
+          #   @return [String, nil]
+          optional :recipient_id, String
+
+          # @!attribute subject
+          #
+          #   @return [String, nil]
+          optional :subject, String
+
+          # @!attribute to
+          #   Legacy message-scoped address, or an empty string when absent.
+          #
+          #   @return [Telnyx::Models::EmailWebhookRecipient, String, nil]
+          optional :to, union: -> { Telnyx::Models::EmailEventListResponse::Data::Payload::To }
+
+          # @!method initialize(id:, occurred_at:, status:, bcc: nil, cc: nil, from: nil, recipient_id: nil, subject: nil, to: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::EmailEventListResponse::Data::Payload} for more details.
+          #
+          #   Payload returned by GET /email_events. Every row includes id, status, and
+          #   occurred_at. Recipient-scoped rows also include recipient_id, from, subject, and
+          #   exactly one object-valued to, cc, or bcc field. Legacy or message-scoped rows
+          #   can omit recipient_id and use object-valued or string-valued to/cc fields,
+          #   including an empty string when no address exists; bcc is redacted. If the
+          #   related message or recipient cannot be loaded, the minimal fallback can omit
+          #   from, subject, and recipient fields. Additional persisted public evidence can be
+          #   present.
+          #
+          #   @param id [String] Email message UUID.
+          #
+          #   @param occurred_at [Time]
+          #
+          #   @param status [Symbol, Telnyx::Models::EmailEventListResponse::Data::Payload::Status] Stored event outcome slug, not the authoritative recipient status. Account polli
+          #
+          #   @param bcc [Telnyx::Models::EmailWebhookRecipient, Symbol, Telnyx::Models::EmailEventListResponse::Data::Payload::Bcc]
+          #
+          #   @param cc [Telnyx::Models::EmailWebhookRecipient, String] Legacy message-scoped address, or an empty string when absent.
+          #
+          #   @param from [Telnyx::Models::EmailEventListResponse::Data::Payload::From] Sender projection in account event polling. The display name is explicitly null
+          #
+          #   @param recipient_id [String] Durable email recipient UUID. Present for recipient-scoped events.
+          #
+          #   @param subject [String]
+          #
+          #   @param to [Telnyx::Models::EmailWebhookRecipient, String] Legacy message-scoped address, or an empty string when absent.
+
+          # Stored event outcome slug, not the authoritative recipient status. Account
+          # polling returns the stored name, including suppression, scan, and quarantine
+          # lifecycle names. Webhooks retain legacy payload names: gateway rejections use
+          # failed and MTA expirations use bounced. New sharp stored rows can expose
+          # gw_reject, injection_timeout, or expired. Use the envelope canonical_event_type
+          # to identify the outcome across surfaces.
+          #
+          # @see Telnyx::Models::EmailEventListResponse::Data::Payload#status
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            QUEUED = :queued
+            DEFERRED = :deferred
+            SCHEDULED = :scheduled
+            CANCELLED = :cancelled
+            SANDBOX = :sandbox
+            SENDING = :sending
+            SENT = :sent
+            FAILED = :failed
+            DELIVERED = :delivered
+            BOUNCED = :bounced
+            COMPLAINED = :complained
+            SUPPRESSED = :suppressed
+            REJECTED = :rejected
+            OPENED = :opened
+            CLICKED = :clicked
+            UNSUBSCRIBED = :unsubscribed
+            DAILY_LIMIT_EXCEEDED = :daily_limit_exceeded
+            SCAN_DEFERRED = :scan_deferred
+            QUARANTINED = :quarantined
+            QUARANTINE_RELEASED = :quarantine_released
+            QUARANTINE_RELEASE_DISPATCHED = :quarantine_release_dispatched
+            QUARANTINE_REJECTED = :quarantine_rejected
+            QUARANTINE_EXPIRED = :quarantine_expired
+            GW_REJECT = :gw_reject
+            INJECTION_TIMEOUT = :injection_timeout
+            EXPIRED = :expired
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Telnyx::Models::EmailEventListResponse::Data::Payload#bcc
+          module Bcc
+            extend Telnyx::Internal::Type::Union
+
+            variant -> { Telnyx::EmailWebhookRecipient }
+
+            variant const: -> { Telnyx::Models::EmailEventListResponse::Data::Payload::Bcc::REDACTED }
+
+            # @!method self.variants
+            #   @return [Array(Telnyx::Models::EmailWebhookRecipient, Symbol)]
+
+            define_sorbet_constant!(:Variants) do
+              T.type_alias do
+                T.any(
+                  Telnyx::EmailWebhookRecipient,
+                  Telnyx::Models::EmailEventListResponse::Data::Payload::Bcc::TaggedSymbol
+                )
+              end
+            end
+
+            # @!group
+
+            REDACTED = :redacted
+
+            # @!endgroup
+          end
+
+          # Legacy message-scoped address, or an empty string when absent.
+          #
+          # @see Telnyx::Models::EmailEventListResponse::Data::Payload#cc
+          module Cc
+            extend Telnyx::Internal::Type::Union
+
+            variant -> { Telnyx::EmailWebhookRecipient }
+
+            # Legacy message-scoped address, or an empty string when absent.
+            variant String
+
+            # @!method self.variants
+            #   @return [Array(Telnyx::Models::EmailWebhookRecipient, String)]
+          end
+
+          # @see Telnyx::Models::EmailEventListResponse::Data::Payload#from
+          class From < Telnyx::Internal::Type::BaseModel
+            # @!attribute email
+            #
+            #   @return [String]
+            required :email, String
+
+            # @!attribute name
+            #
+            #   @return [String, nil]
+            required :name, String, nil?: true
+
+            # @!method initialize(email:, name:)
+            #   Sender projection in account event polling. The display name is explicitly null
+            #   when the message has no sender name.
+            #
+            #   @param email [String]
+            #   @param name [String, nil]
+          end
+
+          # Legacy message-scoped address, or an empty string when absent.
+          #
+          # @see Telnyx::Models::EmailEventListResponse::Data::Payload#to
+          module To
+            extend Telnyx::Internal::Type::Union
+
+            variant -> { Telnyx::EmailWebhookRecipient }
+
+            # Legacy message-scoped address, or an empty string when absent.
+            variant String
+
+            # @!method self.variants
+            #   @return [Array(Telnyx::Models::EmailWebhookRecipient, String)]
+          end
+        end
       end
 
-      # @see Telnyx::Models::EmailEventListResponse#email
-      class Email < Telnyx::Internal::Type::BaseModel
-        # @!attribute cc
+      # @see Telnyx::Models::EmailEventListResponse#meta
+      class Meta < Telnyx::Internal::Type::BaseModel
+        # @!attribute page_size
         #
-        #   @return [Array<Telnyx::Models::EmailInboxes::EmailAddress>]
-        required :cc, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::EmailInboxes::EmailAddress] }
+        #   @return [Integer]
+        required :page_size, Integer
 
-        # @!attribute from
+        # @!attribute time_range
         #
-        #   @return [Telnyx::Models::EmailInboxes::EmailAddress]
-        required :from, -> { Telnyx::EmailInboxes::EmailAddress }
+        #   @return [Telnyx::Models::TimeRange]
+        required :time_range, -> { Telnyx::TimeRange }
 
-        # @!attribute subject
+        # @!attribute page_cursor
+        #   Cursor for the next page, when more results are available.
         #
-        #   @return [String]
-        required :subject, String
+        #   @return [String, nil]
+        optional :page_cursor, String
 
-        # @!attribute to
+        # @!method initialize(page_size:, time_range:, page_cursor: nil)
+        #   @param page_size [Integer]
         #
-        #   @return [Array<Telnyx::Models::EmailInboxes::EmailAddress>]
-        required :to, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::EmailInboxes::EmailAddress] }
-
-        # @!method initialize(cc:, from:, subject:, to:)
-        #   Summary of the associated email message. Present when the email_message preload
-        #   is available.
+        #   @param time_range [Telnyx::Models::TimeRange]
         #
-        #   @param cc [Array<Telnyx::Models::EmailInboxes::EmailAddress>]
-        #   @param from [Telnyx::Models::EmailInboxes::EmailAddress]
-        #   @param subject [String]
-        #   @param to [Array<Telnyx::Models::EmailInboxes::EmailAddress>]
+        #   @param page_cursor [String] Cursor for the next page, when more results are available.
       end
     end
   end

data/lib/telnyx/models/email_event_type.rb

@@ -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
 
@@ -16,11 +22,21 @@ module Telnyx
       DELIVERED = :delivered
       BOUNCED = :bounced
       COMPLAINED = :complained
+      SUPPRESSED = :suppressed
       REJECTED = :rejected
       OPENED = :opened
       CLICKED = :clicked
       UNSUBSCRIBED = :unsubscribed
       DAILY_LIMIT_EXCEEDED = :daily_limit_exceeded
+      SCAN_DEFERRED = :scan_deferred
+      QUARANTINED = :quarantined
+      QUARANTINE_RELEASED = :quarantine_released
+      QUARANTINE_RELEASE_DISPATCHED = :quarantine_release_dispatched
+      QUARANTINE_REJECTED = :quarantine_rejected
+      QUARANTINE_EXPIRED = :quarantine_expired
+      GW_REJECT = :gw_reject
+      INJECTION_TIMEOUT = :injection_timeout
+      EXPIRED = :expired
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/telnyx/models/email_inboxes/email_message.rb

@@ -32,14 +32,20 @@ module Telnyx
 
         # @!attribute events
         #
-        #   @return [Array<Telnyx::Models::MessageEvent>]
-        required :events, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::MessageEvent] }
+        #   @return [Array<Telnyx::Models::EmailInboxes::EmailMessage::Event>]
+        required :events, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::EmailInboxes::EmailMessage::Event] }
 
         # @!attribute from
         #
         #   @return [Telnyx::Models::EmailInboxes::EmailAddress]
         required :from, -> { Telnyx::EmailInboxes::EmailAddress }
 
+        # @!attribute metadata
+        #   Customer-supplied metadata stored with the message.
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
         # @!attribute record_type
         #
         #   @return [Symbol, Telnyx::Models::EmailInboxes::EmailMessage::RecordType]
@@ -63,6 +69,12 @@ module Telnyx
         #   @return [String]
         required :subject, String
 
+        # @!attribute tags
+        #   Customer-supplied tags stored with the message.
+        #
+        #   @return [Array<String>]
+        required :tags, Telnyx::Internal::Type::ArrayOf[String]
+
         # @!attribute template_id
         #
         #   @return [String, nil]
@@ -115,7 +127,7 @@ module Telnyx
         #   @return [Array<Telnyx::Models::SuppressedRecipient>, nil]
         optional :suppressed, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::SuppressedRecipient] }
 
-        # @!method initialize(id:, attachments:, bcc:, cc:, created_at:, events:, from:, record_type:, reply_to:, status:, subject:, template_id:, template_variables:, to:, inline_css: nil, recipient_statuses: nil, sandbox: nil, scheduled_at: nil, suppressed: nil)
+        # @!method initialize(id:, attachments:, bcc:, cc:, created_at:, events:, from:, metadata:, record_type:, reply_to:, status:, subject:, tags:, template_id:, template_variables:, to:, inline_css: nil, recipient_statuses: nil, sandbox: nil, scheduled_at: nil, suppressed: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::EmailInboxes::EmailMessage} for more details.
         #
@@ -129,10 +141,12 @@ module Telnyx
         #
         #   @param created_at [Time]
         #
-        #   @param events [Array<Telnyx::Models::MessageEvent>]
+        #   @param events [Array<Telnyx::Models::EmailInboxes::EmailMessage::Event>]
         #
         #   @param from [Telnyx::Models::EmailInboxes::EmailAddress]
         #
+        #   @param metadata [Hash{Symbol=>Object}] Customer-supplied metadata stored with the message.
+        #
         #   @param record_type [Symbol, Telnyx::Models::EmailInboxes::EmailMessage::RecordType]
         #
         #   @param reply_to [String, nil]
@@ -141,6 +155,8 @@ module Telnyx
         #
         #   @param subject [String]
         #
+        #   @param tags [Array<String>] Customer-supplied tags stored with the message.
+        #
         #   @param template_id [String, nil]
         #
         #   @param template_variables [Hash{Symbol=>Object}]
@@ -220,6 +236,42 @@ module Telnyx
           #   @param url [String, nil] Telnyx-hosted public URL for the attachment content.
         end
 
+        class Event < Telnyx::Internal::Type::BaseModel
+          # @!attribute occurred_at
+          #
+          #   @return [Time]
+          required :occurred_at, Time
+
+          # @!attribute type
+          #   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.
+          #
+          #   @return [Symbol, Telnyx::Models::EmailEventType]
+          required :type, enum: -> { Telnyx::EmailEventType }
+
+          # @!attribute payload
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :payload, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!method initialize(occurred_at:, type:, payload: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::EmailInboxes::EmailMessage::Event} for more details.
+          #
+          #   An event embedded in a message response. The dedicated per-message events
+          #   endpoint additionally returns event_type and canonical_event_type.
+          #
+          #   @param occurred_at [Time]
+          #
+          #   @param type [Symbol, Telnyx::Models::EmailEventType] Bare stored event names returned by message history. In addition to the normal s
+          #
+          #   @param payload [Hash{Symbol=>Object}]
+        end
+
         # @see Telnyx::Models::EmailInboxes::EmailMessage#record_type
         module RecordType
           extend Telnyx::Internal::Type::Enum