sentdm 0.33.0 → 0.34.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88e9bb540faf8a7261b5e38bb2b040df80d8f02124ae52f313d7d0019fe84042
-  data.tar.gz: 52b07edc509cd9c60d586cffede3b951ba9e8f8de1b34776c1b9d86655dd2dfc
+  metadata.gz: 8b4444164d11b8913195b89a66ba9d140e5edaca680199f80156774e39f3f893
+  data.tar.gz: 38b18a67c9dc58ed79f990686d0363fbab3138b66c9a2e3b20eb76ba0d4d4988
 SHA512:
-  metadata.gz: 83049b88e719812408bf187ebb7d8723c45368fc89ff7d21dce6cdd2cdd2c74f892da306081d5b9af50df59668a69160b91a11bd6796d978560738bbfd3a0fc5
-  data.tar.gz: 95eb98fb732c34e1ce224cfdfec45193477bd8aae18e5daf6d5da3bee50a3018c712304da29fbf146b2f92c330d512d617a82fbeb77dd4f1a25f4752c2566929
+  metadata.gz: bd38b5407cb704af0bf1cfecccb4f4bdcc2b5b173ac638d7c3f4c8e5a6039a019637d46114d6c082ebc420f7ad3532cfd128493f56d7bff51c62abc62cf34461
+  data.tar.gz: 3a79e6d405c70edc8e4479f28dc4955c0e0a3fbfaa59da458848c831e99650d90e87c672316609514fb9d5bd4d2b61d194d3f54a31d6c7ecac9340b12117e887

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.34.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.33.0...v0.34.0) (2026-09-30)
+
+
+### Features
+
+* **api:** sync OpenAPI spec from production ([d7d4ecf](https://github.com/sentdm/sent-dm-ruby/commit/d7d4ecf5dd378e69ee6f5148b816554ebbf1a6bf))
+
 ## [0.33.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.32.0...v0.33.0) (2026-09-30)
 
 

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "sentdm", "~> 0.33.0"
+gem "sentdm", "~> 0.34.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/sentdm/models/channel_event_payload.rb

@@ -61,14 +61,22 @@ module Sentdm
       optional :number_type, String, nil?: true
 
       # @!attribute reason
-      #   Why the market reached this state, when a reason was given — a correction
-      #   explained, or a campaign lapse. Free text, passed through from the registry or
-      #   carrier that wrote it, so treat it as a message to show a human rather than a
-      #   value to branch on.
+      #   Why the market reached this state, as a sentence to show a person: the specific
+      #   explanation when one was given (a correction explained, a campaign lapse),
+      #   otherwise what reason_code means for this market. Not a value to branch on.
       #
       #   @return [String, nil]
       optional :reason, String, nil?: true
 
+      # @!attribute reason_code
+      #   Why the market is not ACTIVE, as a stable code: an ErrorCodes CHANNEL_xxx value
+      #   such as CHANNEL_001 (something you owe) or CHANNEL_002 (a correction was
+      #   requested). The same code the channels resource reports for the market. Switch
+      #   on this rather than on reason. Omitted while ACTIVE.
+      #
+      #   @return [String, nil]
+      optional :reason_code, String, nil?: true
+
       # @!attribute sender_value
       #   The sender itself — a number in E.164, or an alphanumeric sender ID.
       #
@@ -107,7 +115,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(country:, account_id: nil, channel: nil, compliance: nil, number_type: nil, reason: nil, sender_value: nil, status: nil, updated_at: nil)
+      # @!method initialize(country:, account_id: nil, channel: nil, compliance: nil, number_type: nil, reason: nil, reason_code: nil, sender_value: nil, status: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::ChannelEventPayload} for more details.
       #
@@ -142,7 +150,9 @@ module Sentdm
       #
       #   @param number_type [String, nil] The kind of sender the market uses, for example TEN_DLC, LOCAL, or
       #
-      #   @param reason [String, nil] Why the market reached this state, when a reason was given — a correction explai
+      #   @param reason [String, nil] Why the market reached this state, as a sentence to show a person: the specific
+      #
+      #   @param reason_code [String, nil] Why the market is not ACTIVE, as a stable code: an ErrorCodes CHANNEL_xxx value
       #
       #   @param sender_value [String, nil] The sender itself — a number in E.164, or an alphanumeric sender ID.
       #

data/lib/sentdm/models/conversation_messages_list.rb

@@ -94,6 +94,24 @@ module Sentdm
         #   @return [Float, nil]
         optional :price, Float, nil?: true
 
+        # @!attribute reason
+        #   A human-readable sentence for reason_code, for example "Insufficient balance".
+        #   Omitted whenever reason_code is.
+        #
+        #   @return [String, nil]
+        optional :reason, String, nil?: true
+
+        # @!attribute reason_code
+        #   Why the message is at its current status, as a stable platform code such as
+        #   DELIVERY_007, BUSINESS_003 or DELIVERY_003. Present when the current status is
+        #   FAILED, FILTERED or BLOCKED and the lifecycle was loaded; omitted otherwise.
+        #   Switch on this rather than on reason: the code is stable, the wording may be
+        #   improved. It is the platform's classification of the outcome, never a carrier or
+        #   vendor code.
+        #
+        #   @return [String, nil]
+        optional :reason_code, String, nil?: true
+
         # @!attribute region_code
         #
         #   @return [String, nil]
@@ -119,7 +137,7 @@ module Sentdm
         #   @return [String, nil]
         optional :template_name, String, nil?: true
 
-        # @!method initialize(id: nil, active_contact_price: nil, channel: nil, contact_id: nil, created_at: nil, customer_id: nil, direction: nil, events: nil, message_body: nil, phone: nil, phone_international: nil, price: nil, region_code: nil, status: nil, template_category: nil, template_id: nil, template_name: nil)
+        # @!method initialize(id: nil, active_contact_price: nil, channel: nil, contact_id: nil, created_at: nil, customer_id: nil, direction: nil, events: nil, message_body: nil, phone: nil, phone_international: nil, price: nil, reason: nil, reason_code: nil, region_code: nil, status: nil, template_category: nil, template_id: nil, template_name: nil)
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::ConversationMessagesList::Message} for more details.
         #
@@ -154,6 +172,10 @@ module Sentdm
         #
         #   @param price [Float, nil]
         #
+        #   @param reason [String, nil] A human-readable sentence for reason_code, for example "Insufficient balance". O
+        #
+        #   @param reason_code [String, nil] Why the message is at its current status, as a stable platform code such as
+        #
         #   @param region_code [String]
         #
         #   @param status [String]
@@ -180,12 +202,37 @@ module Sentdm
           #   @return [String, nil]
           optional :description, String, nil?: true
 
-          # @!method initialize(status:, timestamp:, description: nil)
+          # @!attribute reason
+          #   A human-readable sentence for reason_code. Omitted whenever reason_code is.
+          #
+          #   @return [String, nil]
+          optional :reason, String, nil?: true
+
+          # @!attribute reason_code
+          #   Why the message reached this status, as a stable platform code such as
+          #   DELIVERY_007. Present on FAILED, FILTERED and BLOCKED events; omitted on every
+          #   status that needs no explanation. Same wire name and vocabulary as on the
+          #   activities list and the webhook.
+          #
+          #   @return [String, nil]
+          optional :reason_code, String, nil?: true
+
+          # @!method initialize(status:, timestamp:, description: nil, reason: nil, reason_code: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::ConversationMessagesList::Message::Event} for more details.
+          #
           #   Represents a status change event in a message's lifecycle (v3)
           #
           #   @param status [String]
+          #
           #   @param timestamp [Time]
+          #
           #   @param description [String, nil]
+          #
+          #   @param reason [String, nil] A human-readable sentence for reason_code. Omitted whenever reason_code is.
+          #
+          #   @param reason_code [String, nil] Why the message reached this status, as a stable platform code such as
+          #   DELIVERY\_
         end
 
         # @see Sentdm::Models::ConversationMessagesList::Message#message_body
@@ -332,32 +379,72 @@ module Sentdm
 
           class Media < Sentdm::Internal::Type::BaseModel
             # @!attribute media_type
-            #   One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
-            #   fetched object's Content-Type, not this.
+            #   One of MmsMediaTypes when the content type is known. Advisory — a reader should
+            #   trust the fetched object's own Content-Type.
             #
             #   @return [String, nil]
             optional :media_type, String, api_name: :mediaType, nil?: true
 
+            # @!attribute mime_type
+            #   Content type as the provider declared it. Null when it declared none.
+            #
+            #   @return [String, nil]
+            optional :mime_type, String, api_name: :mimeType, nil?: true
+
+            # @!attribute size_bytes
+            #   Size as the provider declared it. Never measured here — nothing downloads the
+            #   file.
+            #
+            #   @return [Integer, nil]
+            optional :size_bytes, Integer, api_name: :sizeBytes, nil?: true
+
+            # @!attribute source_hash_sha256
+            #   Inbound only: the SHA-256 the provider declared alongside the attachment, when
+            #   it declared one. Relayed to the customer so they can verify what they fetch
+            #   matches what the carrier said it sent. It is the only integrity signal available
+            #   on an attachment nobody here has read.
+            #
+            #   @return [String, nil]
+            optional :source_hash_sha256, String, api_name: :sourceHashSha256, nil?: true
+
             # @!attribute url
+            #   Where the file lives. Outbound: the URL the customer gave us and the carrier
+            #   fetched. Inbound: the URL the carrier hosts it at, relayed unchanged.
             #
             #   @return [String, nil]
-            optional :url, String
+            optional :url, String, nil?: true
 
-            # @!method initialize(media_type: nil, url: nil)
+            # @!method initialize(media_type: nil, mime_type: nil, size_bytes: nil, source_hash_sha256: nil, url: nil)
             #   Some parameter documentations has been truncated, see
             #   {Sentdm::Models::ConversationMessagesList::Message::MessageBody::Media} for more
             #   details.
             #
-            #   One attachment on a message: a customer-supplied public URL handed to the
-            #   carrier as-is.
+            #   One attachment on a message, in either direction — and in both, a URL somebody
+            #   else hosts.
+            #
+            #   Outbound: the customer supplied a public URL and we handed it to the carrier.
+            #   Inbound: the carrier hosts the file and we record where. sent.dm never holds the
+            #   bytes, so there is no key, no expiry bookkeeping and nothing minted per read —
+            #   what is stored is what is served.
+            #
+            #   An inbound link expires on the carrier's own schedule and is unauthenticated.
+            #   That is the customer's to manage, and it is documented where they will see it
+            #   rather than only here — a recipient who needs an attachment to outlive that
+            #   window copies it on receipt.
+            #
+            #   Storing a presigned URL is the specific mistake this shape still avoids:
+            #   M260826130000 and M260826140000 exist because RCS assets were stored as signed
+            #   URLs and went stale. Nothing here is signed.
+            #
+            #   @param media_type [String, nil] One of MmsMediaTypes when the content type is known. Advisory — a reader should
+            #
+            #   @param mime_type [String, nil] Content type as the provider declared it. Null when it declared none.
             #
-            #                A URL and nothing else. sent.dm never takes custody of MMS media — the customer hosts it and we
-            #                pass the link through at send time — so there is no storage key, size or expiry to record. If we ever
-            #                do host attachments, that belongs with the change that introduces the hosting, not here.
+            #   @param size_bytes [Integer, nil] Size as the provider declared it. Never measured here — nothing downloads the fi
             #
-            #   @param media_type [String, nil] One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #   @param source_hash_sha256 [String, nil] Inbound only: the SHA-256 the provider declared alongside the attachment, when i
             #
-            #   @param url [String]
+            #   @param url [String, nil] Where the file lives. Outbound: the URL the customer gave us and the carrier fet
           end
         end
       end

data/lib/sentdm/models/inbound_message_event_payload.rb

@@ -22,11 +22,28 @@ module Sentdm
       optional :account_id, String
 
       # @!attribute channel
-      #   The channel the message arrived on, for example sms or whatsapp.
+      #   The channel the message arrived on, for example sms or mms.
       #
       #   @return [String, nil]
       optional :channel, String
 
+      # @!attribute media
+      #   Attachments the contact sent, present only on channels that carry them (mms
+      #   today) and omitted entirely otherwise.
+      #
+      #   Each url points at the carrier's own copy of the file — sent.dm records where
+      #   the attachment is, not the attachment itself. The link is unauthenticated and
+      #   expires on the carrier's schedule, which differs between them: assume days, not
+      #   months. Download what you need on receipt; re-reading the message through GET
+      #   /v3/messages/{id} returns the same stored link, not a fresh one, so once it
+      #   lapses the entry remains with whatever the carrier declared about the file but
+      #   the file is no longer reachable.
+      #
+      #   @return [Array<Sentdm::Models::InboundMessageEventPayload::Media>, nil]
+      optional :media,
+               -> { Sentdm::Internal::Type::ArrayOf[Sentdm::InboundMessageEventPayload::Media] },
+               nil?: true
+
       # @!attribute message_id
       #   The inbound message.
       #
@@ -54,7 +71,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(inbound_number:, received_at:, account_id: nil, channel: nil, message_id: nil, outbound_number: nil, text: nil, updated_at: nil)
+      # @!method initialize(inbound_number:, received_at:, account_id: nil, channel: nil, media: nil, message_id: nil, outbound_number: nil, text: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::InboundMessageEventPayload} for more details.
       #
@@ -67,7 +84,9 @@ module Sentdm
       #
       #   @param account_id [String] The account the message belongs to.
       #
-      #   @param channel [String] The channel the message arrived on, for example sms or whatsapp.
+      #   @param channel [String] The channel the message arrived on, for example sms or mms.
+      #
+      #   @param media [Array<Sentdm::Models::InboundMessageEventPayload::Media>, nil] Attachments the contact sent, present only on channels that carry them (mms toda
       #
       #   @param message_id [String] The inbound message.
       #
@@ -76,6 +95,54 @@ module Sentdm
       #   @param text [String, nil] The message body. Sent as null when the inbound message carried no text, for
       #
       #   @param updated_at [String] When the message was received, in UTC (yyyy-MM-ddTHH:mm:ssZ). Same value as
+
+      class Media < Sentdm::Internal::Type::BaseModel
+        # @!attribute hash_sha256
+        #   SHA-256 of the file as the carrier declared it, when it declares one. Verify
+        #   what you download against this — sent.dm never reads the bytes, so it is the
+        #   only integrity signal available.
+        #
+        #   @return [String, nil]
+        optional :hash_sha256, String, nil?: true
+
+        # @!attribute mime_type
+        #   Content type as the carrier reported it, for example image/jpeg.
+        #
+        #   @return [String, nil]
+        optional :mime_type, String, nil?: true
+
+        # @!attribute size_bytes
+        #   Size in bytes as the carrier declared it. Absent when it declared none.
+        #
+        #   @return [Integer, nil]
+        optional :size_bytes, Integer, nil?: true
+
+        # @!attribute url
+        #   Where the carrier hosts the attachment.
+        #
+        #   This link expires and is not authenticated. sent.dm relays it rather than
+        #   copying the file, so how long it stays fetchable is the carrier's decision and
+        #   differs between them — assume days, not months. Anyone holding the URL can fetch
+        #   it until it lapses. Copy the file on receipt if you need it to outlive that
+        #   window; do not store this URL as a permanent reference.
+        #
+        #   @return [String, nil]
+        optional :url, String, nil?: true
+
+        # @!method initialize(hash_sha256: nil, mime_type: nil, size_bytes: nil, url: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::InboundMessageEventPayload::Media} for more details.
+        #
+        #   One attachment on an inbound message.
+        #
+        #   @param hash_sha256 [String, nil] SHA-256 of the file as the carrier declared it, when it declares one. Verify wha
+        #
+        #   @param mime_type [String, nil] Content type as the carrier reported it, for example image/jpeg.
+        #
+        #   @param size_bytes [Integer, nil] Size in bytes as the carrier declared it. Absent when it declared none.
+        #
+        #   @param url [String, nil] Where the carrier hosts the attachment.
+      end
     end
   end
 end

data/lib/sentdm/models/me_retrieve_response.rb

@@ -77,6 +77,24 @@ module Sentdm
         #   @return [String, nil]
         optional :email, String, nil?: true
 
+        # @!attribute enable_template_auto_creation_for_sp
+        #   Whether this account may mark a template for automatic creation on its sender
+        #   profiles. Granted by Sent per account and off by default, so it is what a
+        #   template-create form reads to decide whether to offer the option at all —
+        #   marking a template without it does nothing.
+        #
+        #   Top-level rather than inside settings, which is written for type: "profile" only
+        #   and so would never carry it to the account type that can act on it.
+        #
+        #   This is the capability, not the stored flag: a profile reports false whatever
+        #   its own row holds. A sender profile owns no sender profiles, so a template it
+        #   marked would have nothing to be created on and the fan-out would never read the
+        #   flag. The admin GET /customers/{id} reports the stored value instead, because
+        #   that is the one an operator granted.
+        #
+        #   @return [Boolean, nil]
+        optional :enable_template_auto_creation_for_sp, Sentdm::Internal::Type::Boolean
+
         # @!attribute icon
         #   Account icon URL
         #
@@ -155,7 +173,7 @@ module Sentdm
         #   @return [String, nil]
         optional :type, String
 
-        # @!method initialize(id: nil, channels: nil, created_at: nil, description: nil, email: nil, icon: nil, name: nil, organization_id: nil, profiles: nil, sending_phone_number: nil, sending_phone_number_profile_id: nil, settings: nil, short_name: nil, status: nil, type: nil)
+        # @!method initialize(id: nil, channels: nil, created_at: nil, description: nil, email: nil, enable_template_auto_creation_for_sp: nil, icon: nil, name: nil, organization_id: nil, profiles: nil, sending_phone_number: nil, sending_phone_number_profile_id: nil, settings: nil, short_name: nil, status: nil, type: nil)
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::MeRetrieveResponse::Data} for more details.
         #
@@ -173,6 +191,8 @@ module Sentdm
         #
         #   @param email [String, nil] Contact email address
         #
+        #   @param enable_template_auto_creation_for_sp [Boolean] Whether this account may mark a template for automatic creation on its sender pr
+        #
         #   @param icon [String, nil] Account icon URL
         #
         #   @param name [String] Account name

data/lib/sentdm/models/message_event_payload.rb

@@ -51,6 +51,24 @@ module Sentdm
       #   @return [String, nil]
       optional :outbound_number, String
 
+      # @!attribute reason
+      #   A human-readable sentence for ReasonCode, for example "The recipient is not
+      #   registered on this channel". Omitted whenever reason_code is.
+      #
+      #   @return [String, nil]
+      optional :reason, String, nil?: true
+
+      # @!attribute reason_code
+      #   Why the message reached this status, as a stable platform code such as
+      #   DELIVERY_007 or BUSINESS_003. Present on message.failed, message.filtered and
+      #   message.blocked; omitted on every status that needs no explanation. Switch on
+      #   this rather than on Reason: the code is stable, the wording may be improved. It
+      #   is the platform's classification of the outcome and never a carrier or vendor
+      #   code.
+      #
+      #   @return [String, nil]
+      optional :reason_code, String, nil?: true
+
       # @!attribute schedule_reason
       #   message.scheduled only: why the message is held, either because you scheduled it
       #   or because the recipient is inside a protected quiet-hours window. Omitted on
@@ -85,7 +103,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(message_status:, account_id: nil, agent_id: nil, body: nil, channel: nil, message_id: nil, outbound_number: nil, schedule_reason: nil, scheduled_at: nil, template_id: nil, template_name: nil, updated_at: nil)
+      # @!method initialize(message_status:, account_id: nil, agent_id: nil, body: nil, channel: nil, message_id: nil, outbound_number: nil, reason: nil, reason_code: nil, schedule_reason: nil, scheduled_at: nil, template_id: nil, template_name: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageEventPayload} for more details.
       #
@@ -107,6 +125,10 @@ module Sentdm
       #
       #   @param outbound_number [String] The recipient's number in E.164 format.
       #
+      #   @param reason [String, nil] A human-readable sentence for ReasonCode, for example "The recipient is not regi
+      #
+      #   @param reason_code [String, nil] Why the message reached this status, as a stable platform code such as
+      #
       #   @param schedule_reason [String, nil] message.scheduled only: why the message is held, either because you scheduled it
       #
       #   @param scheduled_at [String, nil] message.scheduled only: when the held message will be released for delivery, in

data/lib/sentdm/models/message_retrieve_activities_response.rb

@@ -98,6 +98,23 @@ module Sentdm
           #   @return [String, nil]
           optional :price, String, nil?: true
 
+          # @!attribute reason
+          #   A human-readable sentence for reason_code, for example "The recipient is not
+          #   registered on this channel" Omitted whenever reason_code is.
+          #
+          #   @return [String, nil]
+          optional :reason, String, nil?: true
+
+          # @!attribute reason_code
+          #   Why the message reached this status, as a stable platform code such as
+          #   DELIVERY_007 or BUSINESS_003. Present on FAILED, FILTERED and BLOCKED
+          #   activities; omitted on every status that needs no explanation. Switch on this
+          #   rather than on reason: the code is stable, the wording may be improved. Same
+          #   wire name and vocabulary as on the message and the webhook.
+          #
+          #   @return [String, nil]
+          optional :reason_code, String, nil?: true
+
           # @!attribute scheduled_at
           #   SCHEDULED activities only: when the held message will be released for delivery,
           #   in UTC. Same wire name as on the send response, the message and the webhook.
@@ -120,7 +137,7 @@ module Sentdm
           #   @return [Time, nil]
           optional :timestamp, Time
 
-          # @!method initialize(active_contact_price: nil, description: nil, from: nil, price: nil, scheduled_at: nil, status: nil, timestamp: nil)
+          # @!method initialize(active_contact_price: nil, description: nil, from: nil, price: nil, reason: nil, reason_code: nil, scheduled_at: nil, status: nil, timestamp: nil)
           #   Some parameter documentations has been truncated, see
           #   {Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Activity} for more
           #   details.
@@ -139,6 +156,11 @@ module Sentdm
           #
           #   @param price [String, nil] Channel cost for this activity (e.g., SMS/WhatsApp provider cost), formatted to
           #
+          #   @param reason [String, nil] A human-readable sentence for reason_code, for example "The recipient is not reg
+          #
+          #   @param reason_code [String, nil] Why the message reached this status, as a stable platform code such as
+          #   DELIVERY\_
+          #
           #   @param scheduled_at [Time, nil] SCHEDULED activities only: when the held message will be released for delivery,
           #
           #   @param status [String] Activity status. Outbound: QUEUED, PROCESSED, ROUTED, SCHEDULED, SENT, DELIVERED

data/lib/sentdm/models/message_retrieve_status_response.rb

@@ -122,6 +122,24 @@ module Sentdm
         #   @return [Float, nil]
         optional :price, Float, nil?: true
 
+        # @!attribute reason
+        #   A human-readable sentence for reason_code, for example "Insufficient balance".
+        #   Omitted whenever reason_code is.
+        #
+        #   @return [String, nil]
+        optional :reason, String, nil?: true
+
+        # @!attribute reason_code
+        #   Why the message is at its current status, as a stable platform code such as
+        #   DELIVERY_007, BUSINESS_003 or DELIVERY_003. Present when the current status is
+        #   FAILED, FILTERED or BLOCKED and the lifecycle was loaded; omitted otherwise.
+        #   Switch on this rather than on reason: the code is stable, the wording may be
+        #   improved. It is the platform's classification of the outcome, never a carrier or
+        #   vendor code.
+        #
+        #   @return [String, nil]
+        optional :reason_code, String, nil?: true
+
         # @!attribute region_code
         #
         #   @return [String, nil]
@@ -147,7 +165,7 @@ module Sentdm
         #   @return [String, nil]
         optional :template_name, String, nil?: true
 
-        # @!method initialize(id: nil, active_contact_price: nil, channel: nil, contact_id: nil, created_at: nil, customer_id: nil, direction: nil, events: nil, message_body: nil, phone: nil, phone_international: nil, price: nil, region_code: nil, status: nil, template_category: nil, template_id: nil, template_name: nil)
+        # @!method initialize(id: nil, active_contact_price: nil, channel: nil, contact_id: nil, created_at: nil, customer_id: nil, direction: nil, events: nil, message_body: nil, phone: nil, phone_international: nil, price: nil, reason: nil, reason_code: nil, region_code: nil, status: nil, template_category: nil, template_id: nil, template_name: nil)
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::MessageRetrieveStatusResponse::Data} for more details.
         #
@@ -182,6 +200,10 @@ module Sentdm
         #
         #   @param price [Float, nil]
         #
+        #   @param reason [String, nil] A human-readable sentence for reason_code, for example "Insufficient balance". O
+        #
+        #   @param reason_code [String, nil] Why the message is at its current status, as a stable platform code such as
+        #
         #   @param region_code [String]
         #
         #   @param status [String]
@@ -208,12 +230,37 @@ module Sentdm
           #   @return [String, nil]
           optional :description, String, nil?: true
 
-          # @!method initialize(status:, timestamp:, description: nil)
+          # @!attribute reason
+          #   A human-readable sentence for reason_code. Omitted whenever reason_code is.
+          #
+          #   @return [String, nil]
+          optional :reason, String, nil?: true
+
+          # @!attribute reason_code
+          #   Why the message reached this status, as a stable platform code such as
+          #   DELIVERY_007. Present on FAILED, FILTERED and BLOCKED events; omitted on every
+          #   status that needs no explanation. Same wire name and vocabulary as on the
+          #   activities list and the webhook.
+          #
+          #   @return [String, nil]
+          optional :reason_code, String, nil?: true
+
+          # @!method initialize(status:, timestamp:, description: nil, reason: nil, reason_code: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::Event} for more details.
+          #
           #   Represents a status change event in a message's lifecycle (v3)
           #
           #   @param status [String]
+          #
           #   @param timestamp [Time]
+          #
           #   @param description [String, nil]
+          #
+          #   @param reason [String, nil] A human-readable sentence for reason_code. Omitted whenever reason_code is.
+          #
+          #   @param reason_code [String, nil] Why the message reached this status, as a stable platform code such as
+          #   DELIVERY\_
         end
 
         # @see Sentdm::Models::MessageRetrieveStatusResponse::Data#message_body
@@ -356,32 +403,72 @@ module Sentdm
 
           class Media < Sentdm::Internal::Type::BaseModel
             # @!attribute media_type
-            #   One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
-            #   fetched object's Content-Type, not this.
+            #   One of MmsMediaTypes when the content type is known. Advisory — a reader should
+            #   trust the fetched object's own Content-Type.
             #
             #   @return [String, nil]
             optional :media_type, String, api_name: :mediaType, nil?: true
 
+            # @!attribute mime_type
+            #   Content type as the provider declared it. Null when it declared none.
+            #
+            #   @return [String, nil]
+            optional :mime_type, String, api_name: :mimeType, nil?: true
+
+            # @!attribute size_bytes
+            #   Size as the provider declared it. Never measured here — nothing downloads the
+            #   file.
+            #
+            #   @return [Integer, nil]
+            optional :size_bytes, Integer, api_name: :sizeBytes, nil?: true
+
+            # @!attribute source_hash_sha256
+            #   Inbound only: the SHA-256 the provider declared alongside the attachment, when
+            #   it declared one. Relayed to the customer so they can verify what they fetch
+            #   matches what the carrier said it sent. It is the only integrity signal available
+            #   on an attachment nobody here has read.
+            #
+            #   @return [String, nil]
+            optional :source_hash_sha256, String, api_name: :sourceHashSha256, nil?: true
+
             # @!attribute url
+            #   Where the file lives. Outbound: the URL the customer gave us and the carrier
+            #   fetched. Inbound: the URL the carrier hosts it at, relayed unchanged.
             #
             #   @return [String, nil]
-            optional :url, String
+            optional :url, String, nil?: true
 
-            # @!method initialize(media_type: nil, url: nil)
+            # @!method initialize(media_type: nil, mime_type: nil, size_bytes: nil, source_hash_sha256: nil, url: nil)
             #   Some parameter documentations has been truncated, see
             #   {Sentdm::Models::MessageRetrieveStatusResponse::Data::MessageBody::Media} for
             #   more details.
             #
-            #   One attachment on a message: a customer-supplied public URL handed to the
-            #   carrier as-is.
+            #   One attachment on a message, in either direction — and in both, a URL somebody
+            #   else hosts.
+            #
+            #   Outbound: the customer supplied a public URL and we handed it to the carrier.
+            #   Inbound: the carrier hosts the file and we record where. sent.dm never holds the
+            #   bytes, so there is no key, no expiry bookkeeping and nothing minted per read —
+            #   what is stored is what is served.
+            #
+            #   An inbound link expires on the carrier's own schedule and is unauthenticated.
+            #   That is the customer's to manage, and it is documented where they will see it
+            #   rather than only here — a recipient who needs an attachment to outlive that
+            #   window copies it on receipt.
+            #
+            #   Storing a presigned URL is the specific mistake this shape still avoids:
+            #   M260826130000 and M260826140000 exist because RCS assets were stored as signed
+            #   URLs and went stale. Nothing here is signed.
+            #
+            #   @param media_type [String, nil] One of MmsMediaTypes when the content type is known. Advisory — a reader should
+            #
+            #   @param mime_type [String, nil] Content type as the provider declared it. Null when it declared none.
             #
-            #                A URL and nothing else. sent.dm never takes custody of MMS media — the customer hosts it and we
-            #                pass the link through at send time — so there is no storage key, size or expiry to record. If we ever
-            #                do host attachments, that belongs with the change that introduces the hosting, not here.
+            #   @param size_bytes [Integer, nil] Size as the provider declared it. Never measured here — nothing downloads the fi
             #
-            #   @param media_type [String, nil] One of Constants.MmsMediaTypes when known. Advisory — the carrier reads the
+            #   @param source_hash_sha256 [String, nil] Inbound only: the SHA-256 the provider declared alongside the attachment, when i
             #
-            #   @param url [String]
+            #   @param url [String, nil] Where the file lives. Outbound: the URL the customer gave us and the carrier fet
           end
         end
       end