sentdm 0.27.0 → 0.29.0

data/lib/sentdm/models/me_retrieve_response.rb

@@ -15,14 +15,14 @@ module Sentdm
       # @!attribute error
       #   Error information
       #
-      #   @return [Sentdm::Models::ErrorDetail, nil]
-      optional :error, -> { Sentdm::ErrorDetail }, nil?: true
+      #   @return [Sentdm::Models::MeRetrieveResponse::Error, nil]
+      optional :error, -> { Sentdm::Models::MeRetrieveResponse::Error }, nil?: true
 
       # @!attribute meta
       #   Request and response metadata
       #
-      #   @return [Sentdm::Models::APIMeta, nil]
-      optional :meta, -> { Sentdm::APIMeta }
+      #   @return [Sentdm::Models::MeRetrieveResponse::Meta, nil]
+      optional :meta, -> { Sentdm::Models::MeRetrieveResponse::Meta }
 
       # @!attribute success
       #   Indicates whether the request was successful
@@ -38,9 +38,9 @@ module Sentdm
       #
       #   @param data [Sentdm::Models::MeRetrieveResponse::Data, nil] Account response for GET /v3/me endpoint.
       #
-      #   @param error [Sentdm::Models::ErrorDetail, nil] Error information
+      #   @param error [Sentdm::Models::MeRetrieveResponse::Error, nil] Error information
       #
-      #   @param meta [Sentdm::Models::APIMeta] Request and response metadata
+      #   @param meta [Sentdm::Models::MeRetrieveResponse::Meta] Request and response metadata
       #
       #   @param success [Boolean] Indicates whether the request was successful
 
@@ -103,11 +103,37 @@ module Sentdm
         optional :profiles,
                  -> { Sentdm::Internal::Type::ArrayOf[Sentdm::Models::MeRetrieveResponse::Data::Profile] }
 
+        # @!attribute sending_phone_number
+        #   The SMS sender this account sends from in the United States, in E.164 form. Null
+        #   when the account has no US SMS sender.
+        #
+        #   The same value as channels.sms.phone_number, published under both names on
+        #   purpose: sending_phone_number is what this value is already called on GET
+        #   /v3/profiles, so the same key answers the same question whichever of the two
+        #   endpoints you ask. Neither name is preferred over the other and neither is
+        #   deprecated.
+        #
+        #   The same value, not the same presence: this key is always written, including as
+        #   null, whereas channels.sms.phone_number is left out entirely when there is no
+        #   sender.
+        #
+        #   @return [String, nil]
+        optional :sending_phone_number, String, nil?: true
+
+        # @!attribute sending_phone_number_profile_id
+        #   The account that holds sending_phone_number in number inventory: normally this
+        #   account itself, and a different account when the number is held elsewhere. Null
+        #   when there is no US sender, or when the sender is not a number drawn from
+        #   inventory — an alphanumeric sender ID or a short code.
+        #
+        #   @return [String, nil]
+        optional :sending_phone_number_profile_id, String, nil?: true
+
         # @!attribute settings
         #   Profile configuration settings
         #
-        #   @return [Sentdm::Models::ProfileSettings, nil]
-        optional :settings, -> { Sentdm::ProfileSettings }, nil?: true
+        #   @return [Sentdm::Models::MeRetrieveResponse::Data::Settings, nil]
+        optional :settings, -> { Sentdm::Models::MeRetrieveResponse::Data::Settings }, nil?: true
 
         # @!attribute short_name
         #   Short name / abbreviation (only for profile type)
@@ -129,7 +155,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, settings: nil, short_name: nil, status: nil, type: nil)
+        # @!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)
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::MeRetrieveResponse::Data} for more details.
         #
@@ -155,7 +181,11 @@ module Sentdm
         #
         #   @param profiles [Array<Sentdm::Models::MeRetrieveResponse::Data::Profile>] List of profiles (populated for organization type, empty for user and profile ty
         #
-        #   @param settings [Sentdm::Models::ProfileSettings, nil] Profile configuration settings
+        #   @param sending_phone_number [String, nil] The SMS sender this account sends from in the United States, in E.164 form. Null
+        #
+        #   @param sending_phone_number_profile_id [String, nil] The account that holds sending_phone_number in number inventory: normally this a
+        #
+        #   @param settings [Sentdm::Models::MeRetrieveResponse::Data::Settings, nil] Profile configuration settings
         #
         #   @param short_name [String, nil] Short name / abbreviation (only for profile type)
         #
@@ -314,8 +344,8 @@ module Sentdm
           # @!attribute settings
           #   Profile configuration settings
           #
-          #   @return [Sentdm::Models::ProfileSettings, nil]
-          optional :settings, -> { Sentdm::ProfileSettings }
+          #   @return [Sentdm::Models::MeRetrieveResponse::Data::Profile::Settings, nil]
+          optional :settings, -> { Sentdm::Models::MeRetrieveResponse::Data::Profile::Settings }
 
           # @!attribute short_name
           #   Profile short name (abbreviation)
@@ -347,12 +377,242 @@ module Sentdm
           #
           #   @param role [String, nil] User's role in this profile: admin, billing, developer (inherited from organizat
           #
-          #   @param settings [Sentdm::Models::ProfileSettings] Profile configuration settings
+          #   @param settings [Sentdm::Models::MeRetrieveResponse::Data::Profile::Settings] Profile configuration settings
           #
           #   @param short_name [String, nil] Profile short name (abbreviation)
           #
           #   @param status [String, nil] Profile setup status: incomplete, pending_review, approved, rejected
+
+          # @see Sentdm::Models::MeRetrieveResponse::Data::Profile#settings
+          class Settings < Sentdm::Internal::Type::BaseModel
+            # @!attribute allow_contact_sharing
+            #   @deprecated
+            #
+            #   Always false. A profile no longer shares contacts with sibling profiles — it
+            #   sees only what it owns. Retained so existing v3 clients reading
+            #   allow_contact_sharing keep deserializing; it carries no information.
+            #
+            #   @return [Boolean, nil]
+            optional :allow_contact_sharing, Sentdm::Internal::Type::Boolean, nil?: true
+
+            # @!attribute allow_template_sharing
+            #   @deprecated
+            #
+            #   Always false. A profile no longer shares templates with sibling profiles.
+            #   Retained so existing v3 clients reading allow_template_sharing keep
+            #   deserializing; it carries no information.
+            #
+            #   @return [Boolean, nil]
+            optional :allow_template_sharing, Sentdm::Internal::Type::Boolean, nil?: true
+
+            # @!attribute billing_model
+            #   Billing model: profile, organization, or profile_and_organization
+            #
+            #   @return [String, nil]
+            optional :billing_model, String, nil?: true
+
+            # @!attribute inherit_contacts
+            #   @deprecated
+            #
+            #   Always false. A profile no longer inherits its organization's contacts. Retained
+            #   so existing v3 clients reading inherit_contacts keep deserializing; it carries
+            #   no information.
+            #
+            #   @return [Boolean, nil]
+            optional :inherit_contacts, Sentdm::Internal::Type::Boolean, nil?: true
+
+            # @!attribute inherit_tcr_brand
+            #   Whether this profile inherits TCR brand from the organization
+            #
+            #   @return [Boolean, nil]
+            optional :inherit_tcr_brand, Sentdm::Internal::Type::Boolean, nil?: true
+
+            # @!attribute inherit_tcr_campaign
+            #   Whether this profile inherits TCR campaign from the organization
+            #
+            #   @return [Boolean, nil]
+            optional :inherit_tcr_campaign, Sentdm::Internal::Type::Boolean, nil?: true
+
+            # @!attribute inherit_templates
+            #   @deprecated
+            #
+            #   Always false. A profile no longer inherits its organization's templates.
+            #   Retained so existing v3 clients reading inherit_templates keep deserializing; it
+            #   carries no information.
+            #
+            #   @return [Boolean, nil]
+            optional :inherit_templates, Sentdm::Internal::Type::Boolean, nil?: true
+
+            # @!method initialize(allow_contact_sharing: nil, allow_template_sharing: nil, billing_model: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Sentdm::Models::MeRetrieveResponse::Data::Profile::Settings} for more details.
+            #
+            #   Profile configuration settings
+            #
+            #   @param allow_contact_sharing [Boolean, nil] Always false. A profile no longer shares contacts with sibling profiles — it see
+            #
+            #   @param allow_template_sharing [Boolean, nil] Always false. A profile no longer shares templates with sibling profiles. Retain
+            #
+            #   @param billing_model [String, nil] Billing model: profile, organization, or profile_and_organization
+            #
+            #   @param inherit_contacts [Boolean, nil] Always false. A profile no longer inherits its organization's contacts. Retained
+            #
+            #   @param inherit_tcr_brand [Boolean, nil] Whether this profile inherits TCR brand from the organization
+            #
+            #   @param inherit_tcr_campaign [Boolean, nil] Whether this profile inherits TCR campaign from the organization
+            #
+            #   @param inherit_templates [Boolean, nil] Always false. A profile no longer inherits its organization's templates. Retaine
+          end
         end
+
+        # @see Sentdm::Models::MeRetrieveResponse::Data#settings
+        class Settings < Sentdm::Internal::Type::BaseModel
+          # @!attribute allow_contact_sharing
+          #   @deprecated
+          #
+          #   Always false. A profile no longer shares contacts with sibling profiles — it
+          #   sees only what it owns. Retained so existing v3 clients reading
+          #   allow_contact_sharing keep deserializing; it carries no information.
+          #
+          #   @return [Boolean, nil]
+          optional :allow_contact_sharing, Sentdm::Internal::Type::Boolean, nil?: true
+
+          # @!attribute allow_template_sharing
+          #   @deprecated
+          #
+          #   Always false. A profile no longer shares templates with sibling profiles.
+          #   Retained so existing v3 clients reading allow_template_sharing keep
+          #   deserializing; it carries no information.
+          #
+          #   @return [Boolean, nil]
+          optional :allow_template_sharing, Sentdm::Internal::Type::Boolean, nil?: true
+
+          # @!attribute billing_model
+          #   Billing model: profile, organization, or profile_and_organization
+          #
+          #   @return [String, nil]
+          optional :billing_model, String, nil?: true
+
+          # @!attribute inherit_contacts
+          #   @deprecated
+          #
+          #   Always false. A profile no longer inherits its organization's contacts. Retained
+          #   so existing v3 clients reading inherit_contacts keep deserializing; it carries
+          #   no information.
+          #
+          #   @return [Boolean, nil]
+          optional :inherit_contacts, Sentdm::Internal::Type::Boolean, nil?: true
+
+          # @!attribute inherit_tcr_brand
+          #   Whether this profile inherits TCR brand from the organization
+          #
+          #   @return [Boolean, nil]
+          optional :inherit_tcr_brand, Sentdm::Internal::Type::Boolean, nil?: true
+
+          # @!attribute inherit_tcr_campaign
+          #   Whether this profile inherits TCR campaign from the organization
+          #
+          #   @return [Boolean, nil]
+          optional :inherit_tcr_campaign, Sentdm::Internal::Type::Boolean, nil?: true
+
+          # @!attribute inherit_templates
+          #   @deprecated
+          #
+          #   Always false. A profile no longer inherits its organization's templates.
+          #   Retained so existing v3 clients reading inherit_templates keep deserializing; it
+          #   carries no information.
+          #
+          #   @return [Boolean, nil]
+          optional :inherit_templates, Sentdm::Internal::Type::Boolean, nil?: true
+
+          # @!method initialize(allow_contact_sharing: nil, allow_template_sharing: nil, billing_model: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Sentdm::Models::MeRetrieveResponse::Data::Settings} for more details.
+          #
+          #   Profile configuration settings
+          #
+          #   @param allow_contact_sharing [Boolean, nil] Always false. A profile no longer shares contacts with sibling profiles — it see
+          #
+          #   @param allow_template_sharing [Boolean, nil] Always false. A profile no longer shares templates with sibling profiles. Retain
+          #
+          #   @param billing_model [String, nil] Billing model: profile, organization, or profile_and_organization
+          #
+          #   @param inherit_contacts [Boolean, nil] Always false. A profile no longer inherits its organization's contacts. Retained
+          #
+          #   @param inherit_tcr_brand [Boolean, nil] Whether this profile inherits TCR brand from the organization
+          #
+          #   @param inherit_tcr_campaign [Boolean, nil] Whether this profile inherits TCR campaign from the organization
+          #
+          #   @param inherit_templates [Boolean, nil] Always false. A profile no longer inherits its organization's templates. Retaine
+        end
+      end
+
+      # @see Sentdm::Models::MeRetrieveResponse#error
+      class Error < Sentdm::Internal::Type::BaseModel
+        # @!attribute code
+        #   Machine-readable error code (e.g., "RESOURCE_001")
+        #
+        #   @return [String, nil]
+        optional :code, String
+
+        # @!attribute details
+        #   Additional validation error details (field-level errors)
+        #
+        #   @return [Hash{Symbol=>Array<String>}, nil]
+        optional :details, Sentdm::Internal::Type::HashOf[Sentdm::Internal::Type::ArrayOf[String]], nil?: true
+
+        # @!attribute doc_url
+        #   URL to documentation about this error
+        #
+        #   @return [String, nil]
+        optional :doc_url, String, nil?: true
+
+        # @!attribute message
+        #   Human-readable error message
+        #
+        #   @return [String, nil]
+        optional :message, String
+
+        # @!method initialize(code: nil, details: nil, doc_url: nil, message: nil)
+        #   Error information
+        #
+        #   @param code [String] Machine-readable error code (e.g., "RESOURCE_001")
+        #
+        #   @param details [Hash{Symbol=>Array<String>}, nil] Additional validation error details (field-level errors)
+        #
+        #   @param doc_url [String, nil] URL to documentation about this error
+        #
+        #   @param message [String] Human-readable error message
+      end
+
+      # @see Sentdm::Models::MeRetrieveResponse#meta
+      class Meta < Sentdm::Internal::Type::BaseModel
+        # @!attribute request_id
+        #   Unique identifier for this request (for tracing and support)
+        #
+        #   @return [String, nil]
+        optional :request_id, String
+
+        # @!attribute timestamp
+        #   Server timestamp when the response was generated
+        #
+        #   @return [Time, nil]
+        optional :timestamp, Time
+
+        # @!attribute version
+        #   API version used for this request
+        #
+        #   @return [String, nil]
+        optional :version, String
+
+        # @!method initialize(request_id: nil, timestamp: nil, version: nil)
+        #   Request and response metadata
+        #
+        #   @param request_id [String] Unique identifier for this request (for tracing and support)
+        #
+        #   @param timestamp [Time] Server timestamp when the response was generated
+        #
+        #   @param version [String] API version used for this request
       end
     end
   end

data/lib/sentdm/models/message_event_payload.rb

@@ -3,6 +3,14 @@
 module Sentdm
   module Models
     class MessageEventPayload < Sentdm::Internal::Type::BaseModel
+      # @!attribute message_status
+      #   The status the message just reached, for example SENT, DELIVERED, or FAILED.
+      #   Sent means dispatched and delivered means confirmed, so treat them as distinct
+      #   outcomes.
+      #
+      #   @return [String]
+      required :message_status, String
+
       # @!attribute account_id
       #   The account the message belongs to.
       #
@@ -29,14 +37,6 @@ module Sentdm
       #   @return [String, nil]
       optional :message_id, String
 
-      # @!attribute message_status
-      #   The status the message just reached, for example SENT, DELIVERED, or FAILED.
-      #   Sent means dispatched and delivered means confirmed, so treat them as distinct
-      #   outcomes.
-      #
-      #   @return [String, nil]
-      optional :message_status, String
-
       # @!attribute outbound_number
       #   The recipient's number in E.164 format.
       #
@@ -62,7 +62,7 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(account_id: nil, agent_id: nil, channel: nil, message_id: nil, message_status: nil, outbound_number: nil, template_id: nil, template_name: nil, updated_at: nil)
+      # @!method initialize(message_status:, account_id: nil, agent_id: nil, channel: nil, message_id: nil, outbound_number: nil, template_id: nil, template_name: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::MessageEventPayload} for more details.
       #
@@ -70,6 +70,8 @@ module Sentdm
       #   so a single message produces several of these as it moves toward a terminal
       #   status.
       #
+      #   @param message_status [String] The status the message just reached, for example SENT, DELIVERED, or
+      #
       #   @param account_id [String] The account the message belongs to.
       #
       #   @param agent_id [String, nil] The agent attributed to the send, when the send was attributed to one.
@@ -78,8 +80,6 @@ module Sentdm
       #
       #   @param message_id [String] The message this event describes. Stable across every event in the message's lif
       #
-      #   @param message_status [String] The status the message just reached, for example SENT, DELIVERED, or
-      #
       #   @param outbound_number [String] The recipient's number in E.164 format.
       #
       #   @param template_id [String, nil] The template the message was sent from, when it was sent from one.

data/lib/sentdm/models/message_retrieve_activities_response.rb

@@ -13,14 +13,14 @@ module Sentdm
       # @!attribute error
       #   Error information
       #
-      #   @return [Sentdm::Models::ErrorDetail, nil]
-      optional :error, -> { Sentdm::ErrorDetail }, nil?: true
+      #   @return [Sentdm::Models::MessageRetrieveActivitiesResponse::Error, nil]
+      optional :error, -> { Sentdm::Models::MessageRetrieveActivitiesResponse::Error }, nil?: true
 
       # @!attribute meta
       #   Request and response metadata
       #
-      #   @return [Sentdm::Models::APIMeta, nil]
-      optional :meta, -> { Sentdm::APIMeta }
+      #   @return [Sentdm::Models::MessageRetrieveActivitiesResponse::Meta, nil]
+      optional :meta, -> { Sentdm::Models::MessageRetrieveActivitiesResponse::Meta }
 
       # @!attribute success
       #   Indicates whether the request was successful
@@ -33,9 +33,9 @@ module Sentdm
       #
       #   @param data [Sentdm::Models::MessageRetrieveActivitiesResponse::Data, nil] Response for GET /messages/{id}/activities
       #
-      #   @param error [Sentdm::Models::ErrorDetail, nil] Error information
+      #   @param error [Sentdm::Models::MessageRetrieveActivitiesResponse::Error, nil] Error information
       #
-      #   @param meta [Sentdm::Models::APIMeta] Request and response metadata
+      #   @param meta [Sentdm::Models::MessageRetrieveActivitiesResponse::Meta] Request and response metadata
       #
       #   @param success [Boolean] Indicates whether the request was successful
 
@@ -54,12 +54,20 @@ module Sentdm
         #   @return [String, nil]
         optional :message_id, String
 
-        # @!method initialize(activities: nil, message_id: nil)
+        # @!attribute pagination
+        #   Pagination metadata for list responses
+        #
+        #   @return [Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Pagination, nil]
+        optional :pagination, -> { Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Pagination }
+
+        # @!method initialize(activities: nil, message_id: nil, pagination: nil)
         #   Response for GET /messages/{id}/activities
         #
         #   @param activities [Array<Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Activity>] List of activity events ordered by most recent first
         #
         #   @param message_id [String] The message ID these activities belong to
+        #
+        #   @param pagination [Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Pagination] Pagination metadata for list responses
 
         class Activity < Sentdm::Internal::Type::BaseModel
           # @!attribute active_contact_price
@@ -122,6 +130,156 @@ module Sentdm
           #
           #   @param timestamp [Time] When this activity occurred
         end
+
+        # @see Sentdm::Models::MessageRetrieveActivitiesResponse::Data#pagination
+        class Pagination < Sentdm::Internal::Type::BaseModel
+          # @!attribute cursors
+          #   @deprecated
+          #
+          #   Cursor-based pagination. Never populated — see Cursors.
+          #
+          #   @return [Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Pagination::Cursors, nil]
+          optional :cursors,
+                   -> { Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Pagination::Cursors },
+                   nil?: true
+
+          # @!attribute has_more
+          #   Whether there are more pages after this one
+          #
+          #   @return [Boolean, nil]
+          optional :has_more, Sentdm::Internal::Type::Boolean
+
+          # @!attribute page
+          #   Current page number (1-indexed)
+          #
+          #   @return [Integer, nil]
+          optional :page, Integer
+
+          # @!attribute page_size
+          #   Number of items per page
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!attribute total_count
+          #   Total number of items across all pages
+          #
+          #   @return [Integer, nil]
+          optional :total_count, Integer
+
+          # @!attribute total_pages
+          #   Total number of pages
+          #
+          #   @return [Integer, nil]
+          optional :total_pages, Integer
+
+          # @!method initialize(cursors: nil, has_more: nil, page: nil, page_size: nil, total_count: nil, total_pages: nil)
+          #   Pagination metadata for list responses
+          #
+          #   @param cursors [Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Pagination::Cursors, nil] Cursor-based pagination. Never populated — see Cursors.
+          #
+          #   @param has_more [Boolean] Whether there are more pages after this one
+          #
+          #   @param page [Integer] Current page number (1-indexed)
+          #
+          #   @param page_size [Integer] Number of items per page
+          #
+          #   @param total_count [Integer] Total number of items across all pages
+          #
+          #   @param total_pages [Integer] Total number of pages
+
+          # @deprecated
+          #
+          # @see Sentdm::Models::MessageRetrieveActivitiesResponse::Data::Pagination#cursors
+          class Cursors < Sentdm::Internal::Type::BaseModel
+            # @!attribute after
+            #   Cursor to fetch the next page.
+            #
+            #   @return [String, nil]
+            optional :after, String, nil?: true
+
+            # @!attribute before
+            #   Cursor to fetch the previous page.
+            #
+            #   @return [String, nil]
+            optional :before, String, nil?: true
+
+            # @!method initialize(after: nil, before: nil)
+            #   Cursor-based pagination. Never populated — see Cursors.
+            #
+            #   @param after [String, nil] Cursor to fetch the next page.
+            #
+            #   @param before [String, nil] Cursor to fetch the previous page.
+          end
+        end
+      end
+
+      # @see Sentdm::Models::MessageRetrieveActivitiesResponse#error
+      class Error < Sentdm::Internal::Type::BaseModel
+        # @!attribute code
+        #   Machine-readable error code (e.g., "RESOURCE_001")
+        #
+        #   @return [String, nil]
+        optional :code, String
+
+        # @!attribute details
+        #   Additional validation error details (field-level errors)
+        #
+        #   @return [Hash{Symbol=>Array<String>}, nil]
+        optional :details, Sentdm::Internal::Type::HashOf[Sentdm::Internal::Type::ArrayOf[String]], nil?: true
+
+        # @!attribute doc_url
+        #   URL to documentation about this error
+        #
+        #   @return [String, nil]
+        optional :doc_url, String, nil?: true
+
+        # @!attribute message
+        #   Human-readable error message
+        #
+        #   @return [String, nil]
+        optional :message, String
+
+        # @!method initialize(code: nil, details: nil, doc_url: nil, message: nil)
+        #   Error information
+        #
+        #   @param code [String] Machine-readable error code (e.g., "RESOURCE_001")
+        #
+        #   @param details [Hash{Symbol=>Array<String>}, nil] Additional validation error details (field-level errors)
+        #
+        #   @param doc_url [String, nil] URL to documentation about this error
+        #
+        #   @param message [String] Human-readable error message
+      end
+
+      # @see Sentdm::Models::MessageRetrieveActivitiesResponse#meta
+      class Meta < Sentdm::Internal::Type::BaseModel
+        # @!attribute request_id
+        #   Unique identifier for this request (for tracing and support)
+        #
+        #   @return [String, nil]
+        optional :request_id, String
+
+        # @!attribute timestamp
+        #   Server timestamp when the response was generated
+        #
+        #   @return [Time, nil]
+        optional :timestamp, Time
+
+        # @!attribute version
+        #   API version used for this request
+        #
+        #   @return [String, nil]
+        optional :version, String
+
+        # @!method initialize(request_id: nil, timestamp: nil, version: nil)
+        #   Request and response metadata
+        #
+        #   @param request_id [String] Unique identifier for this request (for tracing and support)
+        #
+        #   @param timestamp [Time] Server timestamp when the response was generated
+        #
+        #   @param version [String] API version used for this request
       end
     end
   end