ark-email 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ad3428e3301ab6c22b19d6447605d4abb3b5a0f73d6cd1ea1b2d02c76b035d7
-  data.tar.gz: cc21c458f90f3facd542034a35b8a47ce91aa7bbd2343f95f3843b79180c8edb
+  metadata.gz: 6255c7791ef262ad25da9374d066c4eeea50052acc0e83258f13a7091a2a2420
+  data.tar.gz: 2358b745c8956be0861bbaec0870dd6961aee04c94857b75ac1be0a0c2e88d65
 SHA512:
-  metadata.gz: f6411dfd7040c48e15573d99340fb44f7ceead905bba5e49f738e599aec3e9a8b3da56d7e7de8786e39c80b7a2d84e296b3b49e2c99bc6d7f1cafc9522182213
-  data.tar.gz: 9c2b777d089eba4e1f7c2fc1ec766c9cb37de4aa951e61a43ce7d361cb4051c76b9901ff2cc359ee69bd96a12e9c6325b066d6def183c0e0f3a4345038012fa8
+  metadata.gz: 5e2b2d595d3891d689a095f6e57c580796ba0033514c1679d8c6d8f145bd76db7bff8b6c7ced06700b8d3e1aae0cb0dac4aab9316c4d6130ba3c78b5494a9582
+  data.tar.gz: 12d2ec03093ce4603a223474bd4ed4939c7cda16dd4546660ff431867c35336836aa282eea11f02a79e138a9b9017bf37984b62fb2ebaa186a576d31418aa6a9

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.19.0 (2026-02-07)
+
+Full Changelog: [v0.18.0...v0.19.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.18.0...v0.19.0)
+
+### Features
+
+* **api:** add Credentials endpoint ([e1b4536](https://github.com/ArkHQ-io/ark-ruby/commit/e1b45361e3a4e4cfd9de4648def64e2622baea81))
+* **api:** add Platform webhooks ([56ac161](https://github.com/ArkHQ-io/ark-ruby/commit/56ac1617e16253ec182b5705621159edddb8791c))
+* **api:** endpoint updates ([f492b2e](https://github.com/ArkHQ-io/ark-ruby/commit/f492b2e39082aed03ef6d104a1e3d9695e3d66b6))
+* **api:** standardization improvements ([b187d9b](https://github.com/ArkHQ-io/ark-ruby/commit/b187d9b397de264ac9dbf6d7b882b28e6850ddf6))
+* **api:** tenant usage ([b3aca3d](https://github.com/ArkHQ-io/ark-ruby/commit/b3aca3dfd1957992552c18d94bba4cd6e1db31f3))
+
+
+### Bug Fixes
+
+* **client:** loosen json header parsing ([209ac67](https://github.com/ArkHQ-io/ark-ruby/commit/209ac6701b972d01b0d83ec8319bb6a36812909d))
+
+
+### Chores
+
+* **docs:** remove www prefix ([80b201f](https://github.com/ArkHQ-io/ark-ruby/commit/80b201fff6de57f5d2496f488e137ac1535304ef))
+
 ## 0.18.0 (2026-02-03)
 
 Full Changelog: [v0.17.0...v0.18.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.17.0...v0.18.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "ark-email", "~> 0.18.0"
+gem "ark-email", "~> 0.19.0"
 ```
 
 <!-- x-release-please-end -->
@@ -46,7 +46,7 @@ response = ark.emails.send_(
   subject: "Hello World",
   to: ["user@example.com"],
   html: "<h1>Welcome!</h1>",
-  metadata: {user_id: "usr_123", campaign: "onboarding"},
+  metadata: {user_id: "usr_123456", campaign: "onboarding"},
   tag: "welcome"
 )
 
@@ -92,7 +92,7 @@ begin
     subject: "Hello World",
     to: ["user@example.com"],
     html: "<h1>Welcome!</h1>",
-    metadata: {user_id: "usr_123", campaign: "onboarding"},
+    metadata: {user_id: "usr_123456", campaign: "onboarding"},
     tag: "welcome"
   )
 rescue ArkEmail::Errors::APIConnectionError => e
@@ -142,7 +142,7 @@ ark.emails.send_(
   subject: "Hello World",
   to: ["user@example.com"],
   html: "<h1>Welcome!</h1>",
-  metadata: {user_id: "usr_123", campaign: "onboarding"},
+  metadata: {user_id: "usr_123456", campaign: "onboarding"},
   tag: "welcome",
   request_options: {max_retries: 5}
 )
@@ -164,7 +164,7 @@ ark.emails.send_(
   subject: "Hello World",
   to: ["user@example.com"],
   html: "<h1>Welcome!</h1>",
-  metadata: {user_id: "usr_123", campaign: "onboarding"},
+  metadata: {user_id: "usr_123456", campaign: "onboarding"},
   tag: "welcome",
   request_options: {timeout: 5}
 )
@@ -203,7 +203,7 @@ response =
     subject: "Hello World",
     to: ["user@example.com"],
     html: "<h1>Welcome!</h1>",
-    metadata: {user_id: "usr_123", campaign: "onboarding"},
+    metadata: {user_id: "usr_123456", campaign: "onboarding"},
     tag: "welcome",
     request_options: {
       extra_query: {my_query_parameter: value},
@@ -255,7 +255,7 @@ ark.emails.send_(
   subject: "Hello World",
   to: ["user@example.com"],
   html: "<h1>Welcome!</h1>",
-  metadata: {user_id: "usr_123", campaign: "onboarding"},
+  metadata: {user_id: "usr_123456", campaign: "onboarding"},
   tag: "welcome"
 )
 ```
@@ -269,7 +269,7 @@ ark.emails.send_(
   subject: "Hello World",
   to: ["user@example.com"],
   html: "<h1>Welcome!</h1>",
-  metadata: {user_id: "usr_123", campaign: "onboarding"},
+  metadata: {user_id: "usr_123456", campaign: "onboarding"},
   tag: "welcome"
 )
 
@@ -279,7 +279,7 @@ params = ArkEmail::EmailSendParams.new(
   subject: "Hello World",
   to: ["user@example.com"],
   html: "<h1>Welcome!</h1>",
-  metadata: {user_id: "usr_123", campaign: "onboarding"},
+  metadata: {user_id: "usr_123456", campaign: "onboarding"},
   tag: "welcome"
 )
 ark.emails.send_(**params)

data/lib/ark_email/client.rb

@@ -27,27 +27,21 @@ module ArkEmail
     # @return [ArkEmail::Resources::Emails]
     attr_reader :emails
 
-    # @return [ArkEmail::Resources::Domains]
-    attr_reader :domains
-
-    # @return [ArkEmail::Resources::Suppressions]
-    attr_reader :suppressions
-
-    # @return [ArkEmail::Resources::Webhooks]
-    attr_reader :webhooks
-
-    # @return [ArkEmail::Resources::Tracking]
-    attr_reader :tracking
-
     # @return [ArkEmail::Resources::Logs]
     attr_reader :logs
 
     # @return [ArkEmail::Resources::Usage]
     attr_reader :usage
 
+    # @return [ArkEmail::Resources::Limits]
+    attr_reader :limits
+
     # @return [ArkEmail::Resources::Tenants]
     attr_reader :tenants
 
+    # @return [ArkEmail::Resources::Platform]
+    attr_reader :platform
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -102,13 +96,11 @@ module ArkEmail
       )
 
       @emails = ArkEmail::Resources::Emails.new(client: self)
-      @domains = ArkEmail::Resources::Domains.new(client: self)
-      @suppressions = ArkEmail::Resources::Suppressions.new(client: self)
-      @webhooks = ArkEmail::Resources::Webhooks.new(client: self)
-      @tracking = ArkEmail::Resources::Tracking.new(client: self)
       @logs = ArkEmail::Resources::Logs.new(client: self)
       @usage = ArkEmail::Resources::Usage.new(client: self)
+      @limits = ArkEmail::Resources::Limits.new(client: self)
       @tenants = ArkEmail::Resources::Tenants.new(client: self)
+      @platform = ArkEmail::Resources::Platform.new(client: self)
     end
   end
 end

data/lib/ark_email/internal/util.rb

@@ -485,7 +485,7 @@ module ArkEmail
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 

data/lib/ark_email/models/email_counts.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    class EmailCounts < ArkEmail::Internal::Type::BaseModel
+      # @!attribute bounced
+      #   Emails that bounced
+      #
+      #   @return [Integer]
+      required :bounced, Integer
+
+      # @!attribute delivered
+      #   Emails successfully delivered
+      #
+      #   @return [Integer]
+      required :delivered, Integer
+
+      # @!attribute hard_failed
+      #   Emails that hard-failed (permanent failures)
+      #
+      #   @return [Integer]
+      required :hard_failed, Integer
+
+      # @!attribute held
+      #   Emails currently held for review
+      #
+      #   @return [Integer]
+      required :held, Integer
+
+      # @!attribute sent
+      #   Total emails sent
+      #
+      #   @return [Integer]
+      required :sent, Integer
+
+      # @!attribute soft_failed
+      #   Emails that soft-failed (temporary failures, may be retried)
+      #
+      #   @return [Integer]
+      required :soft_failed, Integer
+
+      # @!method initialize(bounced:, delivered:, hard_failed:, held:, sent:, soft_failed:)
+      #   Email delivery counts
+      #
+      #   @param bounced [Integer] Emails that bounced
+      #
+      #   @param delivered [Integer] Emails successfully delivered
+      #
+      #   @param hard_failed [Integer] Emails that hard-failed (permanent failures)
+      #
+      #   @param held [Integer] Emails currently held for review
+      #
+      #   @param sent [Integer] Total emails sent
+      #
+      #   @param soft_failed [Integer] Emails that soft-failed (temporary failures, may be retried)
+    end
+  end
+end

data/lib/ark_email/models/email_rates.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    class EmailRates < ArkEmail::Internal::Type::BaseModel
+      # @!attribute bounce_rate
+      #   Percentage of sent emails that bounced (0-1)
+      #
+      #   @return [Float]
+      required :bounce_rate, Float
+
+      # @!attribute delivery_rate
+      #   Percentage of sent emails that were delivered (0-1)
+      #
+      #   @return [Float]
+      required :delivery_rate, Float
+
+      # @!method initialize(bounce_rate:, delivery_rate:)
+      #   Email delivery rates (as decimals, e.g., 0.95 = 95%)
+      #
+      #   @param bounce_rate [Float] Percentage of sent emails that bounced (0-1)
+      #
+      #   @param delivery_rate [Float] Percentage of sent emails that were delivered (0-1)
+    end
+  end
+end

data/lib/ark_email/models/email_retrieve_deliveries_response.rb

@@ -33,7 +33,7 @@ module ArkEmail
         required :id, String
 
         # @!attribute can_retry_manually
-        #   Whether the message can be manually retried via `POST /emails/{id}/retry`.
+        #   Whether the message can be manually retried via `POST /emails/{emailId}/retry`.
         #   `true` when the raw message content is still available (not expired). Messages
         #   older than the retention period cannot be retried.
         #
@@ -77,7 +77,7 @@ module ArkEmail
         #
         #   @param id [String] Message identifier (token)
         #
-        #   @param can_retry_manually [Boolean] Whether the message can be manually retried via `POST /emails/{id}/retry`.
+        #   @param can_retry_manually [Boolean] Whether the message can be manually retried via `POST /emails/{emailId}/retry`.
         #
         #   @param deliveries [Array<ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery>] Chronological list of delivery attempts for this message.
         #

data/lib/ark_email/models/{webhook_delete_params.rb → limit_retrieve_params.rb}

@@ -2,8 +2,8 @@
 
 module ArkEmail
   module Models
-    # @see ArkEmail::Resources::Webhooks#delete
-    class WebhookDeleteParams < ArkEmail::Internal::Type::BaseModel
+    # @see ArkEmail::Resources::Limits#retrieve
+    class LimitRetrieveParams < ArkEmail::Internal::Type::BaseModel
       extend ArkEmail::Internal::Type::RequestParameters::Converter
       include ArkEmail::Internal::Type::RequestParameters
 

data/lib/ark_email/models/{tracking_retrieve_response.rb → limit_retrieve_response.rb}

@@ -2,12 +2,13 @@
 
 module ArkEmail
   module Models
-    # @see ArkEmail::Resources::Tracking#retrieve
-    class TrackingRetrieveResponse < ArkEmail::Internal::Type::BaseModel
+    # @see ArkEmail::Resources::Limits#retrieve
+    class LimitRetrieveResponse < ArkEmail::Internal::Type::BaseModel
       # @!attribute data
+      #   Current usage and limit information
       #
-      #   @return [ArkEmail::Models::TrackDomain]
-      required :data, -> { ArkEmail::TrackDomain }
+      #   @return [ArkEmail::Models::LimitsData]
+      required :data, -> { ArkEmail::LimitsData }
 
       # @!attribute meta
       #
@@ -20,8 +21,12 @@ module ArkEmail
       required :success, const: true
 
       # @!method initialize(data:, meta:, success: true)
-      #   @param data [ArkEmail::Models::TrackDomain]
+      #   Account rate limits and send limits response
+      #
+      #   @param data [ArkEmail::Models::LimitsData] Current usage and limit information
+      #
       #   @param meta [ArkEmail::Models::APIMeta]
+      #
       #   @param success [Boolean, true]
     end
   end

data/lib/ark_email/models/limits_data.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    class LimitsData < ArkEmail::Internal::Type::BaseModel
+      # @!attribute billing
+      #   Billing and credit information
+      #
+      #   @return [ArkEmail::Models::LimitsData::Billing, nil]
+      required :billing, -> { ArkEmail::LimitsData::Billing }, nil?: true
+
+      # @!attribute rate_limit
+      #   API rate limit status
+      #
+      #   @return [ArkEmail::Models::LimitsData::RateLimit]
+      required :rate_limit, -> { ArkEmail::LimitsData::RateLimit }, api_name: :rateLimit
+
+      # @!attribute send_limit
+      #   Email send limit status (hourly cap)
+      #
+      #   @return [ArkEmail::Models::LimitsData::SendLimit, nil]
+      required :send_limit, -> { ArkEmail::LimitsData::SendLimit }, api_name: :sendLimit, nil?: true
+
+      # @!method initialize(billing:, rate_limit:, send_limit:)
+      #   Current usage and limit information
+      #
+      #   @param billing [ArkEmail::Models::LimitsData::Billing, nil] Billing and credit information
+      #
+      #   @param rate_limit [ArkEmail::Models::LimitsData::RateLimit] API rate limit status
+      #
+      #   @param send_limit [ArkEmail::Models::LimitsData::SendLimit, nil] Email send limit status (hourly cap)
+
+      # @see ArkEmail::Models::LimitsData#billing
+      class Billing < ArkEmail::Internal::Type::BaseModel
+        # @!attribute auto_recharge
+        #   Auto-recharge configuration
+        #
+        #   @return [ArkEmail::Models::LimitsData::Billing::AutoRecharge]
+        required :auto_recharge, -> { ArkEmail::LimitsData::Billing::AutoRecharge }, api_name: :autoRecharge
+
+        # @!attribute credit_balance
+        #   Current credit balance as formatted string (e.g., "25.50")
+        #
+        #   @return [String]
+        required :credit_balance, String, api_name: :creditBalance
+
+        # @!attribute credit_balance_cents
+        #   Current credit balance in cents for precise calculations
+        #
+        #   @return [Integer]
+        required :credit_balance_cents, Integer, api_name: :creditBalanceCents
+
+        # @!attribute has_payment_method
+        #   Whether a payment method is configured
+        #
+        #   @return [Boolean]
+        required :has_payment_method, ArkEmail::Internal::Type::Boolean, api_name: :hasPaymentMethod
+
+        # @!method initialize(auto_recharge:, credit_balance:, credit_balance_cents:, has_payment_method:)
+        #   Billing and credit information
+        #
+        #   @param auto_recharge [ArkEmail::Models::LimitsData::Billing::AutoRecharge] Auto-recharge configuration
+        #
+        #   @param credit_balance [String] Current credit balance as formatted string (e.g., "25.50")
+        #
+        #   @param credit_balance_cents [Integer] Current credit balance in cents for precise calculations
+        #
+        #   @param has_payment_method [Boolean] Whether a payment method is configured
+
+        # @see ArkEmail::Models::LimitsData::Billing#auto_recharge
+        class AutoRecharge < ArkEmail::Internal::Type::BaseModel
+          # @!attribute amount
+          #   Amount to recharge when triggered
+          #
+          #   @return [String]
+          required :amount, String
+
+          # @!attribute enabled
+          #   Whether auto-recharge is enabled
+          #
+          #   @return [Boolean]
+          required :enabled, ArkEmail::Internal::Type::Boolean
+
+          # @!attribute threshold
+          #   Balance threshold that triggers recharge
+          #
+          #   @return [String]
+          required :threshold, String
+
+          # @!method initialize(amount:, enabled:, threshold:)
+          #   Auto-recharge configuration
+          #
+          #   @param amount [String] Amount to recharge when triggered
+          #
+          #   @param enabled [Boolean] Whether auto-recharge is enabled
+          #
+          #   @param threshold [String] Balance threshold that triggers recharge
+        end
+      end
+
+      # @see ArkEmail::Models::LimitsData#rate_limit
+      class RateLimit < ArkEmail::Internal::Type::BaseModel
+        # @!attribute limit
+        #   Maximum requests allowed per period
+        #
+        #   @return [Integer]
+        required :limit, Integer
+
+        # @!attribute period
+        #   Time period for the limit
+        #
+        #   @return [Symbol, ArkEmail::Models::LimitsData::RateLimit::Period]
+        required :period, enum: -> { ArkEmail::LimitsData::RateLimit::Period }
+
+        # @!attribute remaining
+        #   Requests remaining in current window
+        #
+        #   @return [Integer]
+        required :remaining, Integer
+
+        # @!attribute reset
+        #   Unix timestamp when the limit resets
+        #
+        #   @return [Integer]
+        required :reset, Integer
+
+        # @!method initialize(limit:, period:, remaining:, reset:)
+        #   API rate limit status
+        #
+        #   @param limit [Integer] Maximum requests allowed per period
+        #
+        #   @param period [Symbol, ArkEmail::Models::LimitsData::RateLimit::Period] Time period for the limit
+        #
+        #   @param remaining [Integer] Requests remaining in current window
+        #
+        #   @param reset [Integer] Unix timestamp when the limit resets
+
+        # Time period for the limit
+        #
+        # @see ArkEmail::Models::LimitsData::RateLimit#period
+        module Period
+          extend ArkEmail::Internal::Type::Enum
+
+          SECOND = :second
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # @see ArkEmail::Models::LimitsData#send_limit
+      class SendLimit < ArkEmail::Internal::Type::BaseModel
+        # @!attribute approaching
+        #   Whether approaching the limit (>90%)
+        #
+        #   @return [Boolean]
+        required :approaching, ArkEmail::Internal::Type::Boolean
+
+        # @!attribute exceeded
+        #   Whether the limit has been exceeded
+        #
+        #   @return [Boolean]
+        required :exceeded, ArkEmail::Internal::Type::Boolean
+
+        # @!attribute limit
+        #   Maximum emails allowed per hour (null = unlimited)
+        #
+        #   @return [Integer, nil]
+        required :limit, Integer, nil?: true
+
+        # @!attribute period
+        #   Time period for the limit
+        #
+        #   @return [Symbol, ArkEmail::Models::LimitsData::SendLimit::Period]
+        required :period, enum: -> { ArkEmail::LimitsData::SendLimit::Period }
+
+        # @!attribute remaining
+        #   Emails remaining in current period (null if unlimited)
+        #
+        #   @return [Integer, nil]
+        required :remaining, Integer, nil?: true
+
+        # @!attribute resets_at
+        #   ISO timestamp when the limit window resets (top of next hour)
+        #
+        #   @return [Time]
+        required :resets_at, Time, api_name: :resetsAt
+
+        # @!attribute usage_percent
+        #   Usage as a percentage (null if unlimited)
+        #
+        #   @return [Float, nil]
+        required :usage_percent, Float, api_name: :usagePercent, nil?: true
+
+        # @!attribute used
+        #   Emails sent in current period
+        #
+        #   @return [Integer]
+        required :used, Integer
+
+        # @!method initialize(approaching:, exceeded:, limit:, period:, remaining:, resets_at:, usage_percent:, used:)
+        #   Email send limit status (hourly cap)
+        #
+        #   @param approaching [Boolean] Whether approaching the limit (>90%)
+        #
+        #   @param exceeded [Boolean] Whether the limit has been exceeded
+        #
+        #   @param limit [Integer, nil] Maximum emails allowed per hour (null = unlimited)
+        #
+        #   @param period [Symbol, ArkEmail::Models::LimitsData::SendLimit::Period] Time period for the limit
+        #
+        #   @param remaining [Integer, nil] Emails remaining in current period (null if unlimited)
+        #
+        #   @param resets_at [Time] ISO timestamp when the limit window resets (top of next hour)
+        #
+        #   @param usage_percent [Float, nil] Usage as a percentage (null if unlimited)
+        #
+        #   @param used [Integer] Emails sent in current period
+
+        # Time period for the limit
+        #
+        # @see ArkEmail::Models::LimitsData::SendLimit#period
+        module Period
+          extend ArkEmail::Internal::Type::Enum
+
+          HOUR = :hour
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/ark_email/models/org_usage_summary.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Usage#retrieve
+    class OrgUsageSummary < ArkEmail::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [ArkEmail::Models::OrgUsageSummary::Data]
+      required :data, -> { ArkEmail::OrgUsageSummary::Data }
+
+      # @!attribute meta
+      #
+      #   @return [ArkEmail::Models::APIMeta]
+      required :meta, -> { ArkEmail::APIMeta }
+
+      # @!attribute success
+      #
+      #   @return [Boolean, true]
+      required :success, const: true
+
+      # @!method initialize(data:, meta:, success: true)
+      #   Org-wide usage summary response
+      #
+      #   @param data [ArkEmail::Models::OrgUsageSummary::Data]
+      #   @param meta [ArkEmail::Models::APIMeta]
+      #   @param success [Boolean, true]
+
+      # @see ArkEmail::Models::OrgUsageSummary#data
+      class Data < ArkEmail::Internal::Type::BaseModel
+        # @!attribute emails
+        #   Email delivery counts
+        #
+        #   @return [ArkEmail::Models::EmailCounts]
+        required :emails, -> { ArkEmail::EmailCounts }
+
+        # @!attribute period
+        #   Time period for usage data
+        #
+        #   @return [ArkEmail::Models::UsagePeriod]
+        required :period, -> { ArkEmail::UsagePeriod }
+
+        # @!attribute rates
+        #   Email delivery rates (as decimals, e.g., 0.95 = 95%)
+        #
+        #   @return [ArkEmail::Models::EmailRates]
+        required :rates, -> { ArkEmail::EmailRates }
+
+        # @!attribute tenants
+        #
+        #   @return [ArkEmail::Models::OrgUsageSummary::Data::Tenants]
+        required :tenants, -> { ArkEmail::OrgUsageSummary::Data::Tenants }
+
+        # @!method initialize(emails:, period:, rates:, tenants:)
+        #   @param emails [ArkEmail::Models::EmailCounts] Email delivery counts
+        #
+        #   @param period [ArkEmail::Models::UsagePeriod] Time period for usage data
+        #
+        #   @param rates [ArkEmail::Models::EmailRates] Email delivery rates (as decimals, e.g., 0.95 = 95%)
+        #
+        #   @param tenants [ArkEmail::Models::OrgUsageSummary::Data::Tenants]
+
+        # @see ArkEmail::Models::OrgUsageSummary::Data#tenants
+        class Tenants < ArkEmail::Internal::Type::BaseModel
+          # @!attribute active
+          #   Number of active tenants
+          #
+          #   @return [Integer]
+          required :active, Integer
+
+          # @!attribute total
+          #   Total number of tenants
+          #
+          #   @return [Integer]
+          required :total, Integer
+
+          # @!attribute with_activity
+          #   Number of tenants with sending activity
+          #
+          #   @return [Integer]
+          required :with_activity, Integer, api_name: :withActivity
+
+          # @!method initialize(active:, total:, with_activity:)
+          #   @param active [Integer] Number of active tenants
+          #
+          #   @param total [Integer] Total number of tenants
+          #
+          #   @param with_activity [Integer] Number of tenants with sending activity
+        end
+      end
+    end
+  end
+end