ark-email 0.16.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eca12e0e4bd38dc3db2e524b44d3f6ac39c1747b64636fc5b6e5022cb3b471de
-  data.tar.gz: e8173cd50604520b2379e28555896c2414cbb87182cfb9c700ad79411de6b80c
+  metadata.gz: 9ad3428e3301ab6c22b19d6447605d4abb3b5a0f73d6cd1ea1b2d02c76b035d7
+  data.tar.gz: cc21c458f90f3facd542034a35b8a47ce91aa7bbd2343f95f3843b79180c8edb
 SHA512:
-  metadata.gz: 8075f779365578d7000b62549af9479c9a8540119445ecd5be89d00a0f80719bad83bb7f45429ebca6d2f08aab3dc0a2ee9645ce18c1ea65dd73ced2ac90861d
-  data.tar.gz: 60b135d8b1e9fd878a90760159f221daa0735d908546e19b81b4692100584c5e2b445932161d330b40bab49d859cb95e720ea1e48c018955bbf89c7f140db088
+  metadata.gz: f6411dfd7040c48e15573d99340fb44f7ceead905bba5e49f738e599aec3e9a8b3da56d7e7de8786e39c80b7a2d84e296b3b49e2c99bc6d7f1cafc9522182213
+  data.tar.gz: 9c2b777d089eba4e1f7c2fc1ec766c9cb37de4aa951e61a43ce7d361cb4051c76b9901ff2cc359ee69bd96a12e9c6325b066d6def183c0e0f3a4345038012fa8

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** Add Tenants ([3ef25f0](https://github.com/ArkHQ-io/ark-ruby/commit/3ef25f095708d041a15fa89f77872bf0df541a1d))
+* **api:** api update ([787e993](https://github.com/ArkHQ-io/ark-ruby/commit/787e99301d21537f66833fdebe070ad6473fa7b2))
+* **api:** manual updates ([cdd14ab](https://github.com/ArkHQ-io/ark-ruby/commit/cdd14ab06e65b53f4c6b60af46110b3b7966b9ab))
+* **api:** manual updates ([e253498](https://github.com/ArkHQ-io/ark-ruby/commit/e2534989ba9f4ed2378ff37615ef9dadb7c08341))
+* **api:** manual updates ([d15f192](https://github.com/ArkHQ-io/ark-ruby/commit/d15f19216f575fc83493db293e9265cb208d0b6c))
+
+
+### Bug Fixes
+
+* **client:** always add content-length to post body, even when empty ([7ec49ee](https://github.com/ArkHQ-io/ark-ruby/commit/7ec49ee2f06a677b2bf6c976e0a5fa3d959c1b30))
+
+## 0.17.0 (2026-01-30)
+
+Full Changelog: [v0.16.0...v0.17.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.16.0...v0.17.0)
+
+### Features
+
+* **api:** api update ([6f485fb](https://github.com/ArkHQ-io/ark-ruby/commit/6f485fbb86233b47f79314c8cc4887135824a682))
+* **api:** manual updates ([001dca6](https://github.com/ArkHQ-io/ark-ruby/commit/001dca62fad133fe30758f2d3187e3e0ba7f412f))
+
 ## 0.16.0 (2026-01-30)
 
 Full Changelog: [v0.15.0...v0.16.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.15.0...v0.16.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.16.0"
+gem "ark-email", "~> 0.18.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/ark_email/client.rb

@@ -45,6 +45,9 @@ module ArkEmail
     # @return [ArkEmail::Resources::Usage]
     attr_reader :usage
 
+    # @return [ArkEmail::Resources::Tenants]
+    attr_reader :tenants
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -105,6 +108,7 @@ module ArkEmail
       @tracking = ArkEmail::Resources::Tracking.new(client: self)
       @logs = ArkEmail::Resources::Logs.new(client: self)
       @usage = ArkEmail::Resources::Usage.new(client: self)
+      @tenants = ArkEmail::Resources::Tenants.new(client: self)
     end
   end
 end

data/lib/ark_email/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module ArkEmail
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = ArkEmail::Internal::Util::ReadIOAdapter.new(body, &blk)

data/lib/ark_email/models/email_retrieve_deliveries_response.rb

@@ -110,6 +110,25 @@ module ArkEmail
           #   @return [Time]
           required :timestamp_iso, Time, api_name: :timestampIso
 
+          # @!attribute classification
+          #   Bounce classification category (present for failed deliveries). Helps understand
+          #   why delivery failed for analytics and automated handling.
+          #
+          #   @return [Symbol, ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery::Classification, nil]
+          optional :classification,
+                   enum: -> { ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery::Classification },
+                   nil?: true
+
+          # @!attribute classification_code
+          #   Numeric bounce classification code for programmatic handling. Codes:
+          #   10=invalid_recipient, 11=no_mailbox, 12=not_accepting_mail, 20=mailbox_full,
+          #   21=message_too_large, 30=spam_block, 31=policy_violation, 32=tls_required,
+          #   40=connection_error, 41=dns_error, 42=temporarily_unavailable,
+          #   50=protocol_error, 99=unclassified
+          #
+          #   @return [Integer, nil]
+          optional :classification_code, Integer, api_name: :classificationCode, nil?: true
+
           # @!attribute code
           #   SMTP response code
           #
@@ -117,24 +136,47 @@ module ArkEmail
           optional :code, Integer
 
           # @!attribute details
-          #   Status details
+          #   Human-readable delivery summary. Format varies by status:
+          #
+          #   - **sent**: `Message for {recipient} accepted by {ip}:{port} ({hostname})`
+          #   - **softfail/hardfail**:
+          #     `{code} {classification}: Delivery to {recipient} failed at {ip}:{port} ({hostname})`
           #
           #   @return [String, nil]
           optional :details, String
 
           # @!attribute output
-          #   SMTP server response from the receiving mail server
+          #   Raw SMTP response from the receiving mail server
           #
           #   @return [String, nil]
           optional :output, String
 
+          # @!attribute remote_host
+          #   Hostname of the remote mail server that processed the delivery. Present for all
+          #   delivery attempts (successful and failed).
+          #
+          #   @return [String, nil]
+          optional :remote_host, String, api_name: :remoteHost, nil?: true
+
           # @!attribute sent_with_ssl
           #   Whether TLS was used
           #
           #   @return [Boolean, nil]
           optional :sent_with_ssl, ArkEmail::Internal::Type::Boolean, api_name: :sentWithSsl
 
-          # @!method initialize(id:, status:, timestamp:, timestamp_iso:, code: nil, details: nil, output: nil, sent_with_ssl: nil)
+          # @!attribute smtp_enhanced_code
+          #   RFC 3463 enhanced status code from SMTP response (e.g., "5.1.1", "4.2.2"). First
+          #   digit: 2=success, 4=temporary, 5=permanent. Second digit: category (1=address,
+          #   2=mailbox, 7=security, etc.).
+          #
+          #   @return [String, nil]
+          optional :smtp_enhanced_code, String, api_name: :smtpEnhancedCode, nil?: true
+
+          # @!method initialize(id:, status:, timestamp:, timestamp_iso:, classification: nil, classification_code: nil, code: nil, details: nil, output: nil, remote_host: nil, sent_with_ssl: nil, smtp_enhanced_code: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery} for more
+          #   details.
+          #
           #   @param id [String] Delivery attempt ID
           #
           #   @param status [String] Delivery status (lowercase)
@@ -143,13 +185,46 @@ module ArkEmail
           #
           #   @param timestamp_iso [Time] ISO 8601 timestamp
           #
+          #   @param classification [Symbol, ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery::Classification, nil] Bounce classification category (present for failed deliveries).
+          #
+          #   @param classification_code [Integer, nil] Numeric bounce classification code for programmatic handling.
+          #
           #   @param code [Integer] SMTP response code
           #
-          #   @param details [String] Status details
+          #   @param details [String] Human-readable delivery summary. Format varies by status:
+          #
+          #   @param output [String] Raw SMTP response from the receiving mail server
           #
-          #   @param output [String] SMTP server response from the receiving mail server
+          #   @param remote_host [String, nil] Hostname of the remote mail server that processed the delivery.
           #
           #   @param sent_with_ssl [Boolean] Whether TLS was used
+          #
+          #   @param smtp_enhanced_code [String, nil] RFC 3463 enhanced status code from SMTP response (e.g., "5.1.1", "4.2.2").
+
+          # Bounce classification category (present for failed deliveries). Helps understand
+          # why delivery failed for analytics and automated handling.
+          #
+          # @see ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery#classification
+          module Classification
+            extend ArkEmail::Internal::Type::Enum
+
+            INVALID_RECIPIENT = :invalid_recipient
+            MAILBOX_FULL = :mailbox_full
+            MESSAGE_TOO_LARGE = :message_too_large
+            SPAM_BLOCK = :spam_block
+            POLICY_VIOLATION = :policy_violation
+            NO_MAILBOX = :no_mailbox
+            NOT_ACCEPTING_MAIL = :not_accepting_mail
+            TEMPORARILY_UNAVAILABLE = :temporarily_unavailable
+            PROTOCOL_ERROR = :protocol_error
+            TLS_REQUIRED = :tls_required
+            CONNECTION_ERROR = :connection_error
+            DNS_ERROR = :dns_error
+            UNCLASSIFIED = :unclassified
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         # @see ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data#retry_state

data/lib/ark_email/models/email_retrieve_response.rb

@@ -404,6 +404,25 @@ module ArkEmail
           #   @return [Time]
           required :timestamp_iso, Time, api_name: :timestampIso
 
+          # @!attribute classification
+          #   Bounce classification category (present for failed deliveries). Helps understand
+          #   why delivery failed for analytics and automated handling.
+          #
+          #   @return [Symbol, ArkEmail::Models::EmailRetrieveResponse::Data::Delivery::Classification, nil]
+          optional :classification,
+                   enum: -> { ArkEmail::Models::EmailRetrieveResponse::Data::Delivery::Classification },
+                   nil?: true
+
+          # @!attribute classification_code
+          #   Numeric bounce classification code for programmatic handling. Codes:
+          #   10=invalid_recipient, 11=no_mailbox, 12=not_accepting_mail, 20=mailbox_full,
+          #   21=message_too_large, 30=spam_block, 31=policy_violation, 32=tls_required,
+          #   40=connection_error, 41=dns_error, 42=temporarily_unavailable,
+          #   50=protocol_error, 99=unclassified
+          #
+          #   @return [Integer, nil]
+          optional :classification_code, Integer, api_name: :classificationCode, nil?: true
+
           # @!attribute code
           #   SMTP response code
           #
@@ -411,24 +430,46 @@ module ArkEmail
           optional :code, Integer
 
           # @!attribute details
-          #   Status details
+          #   Human-readable delivery summary. Format varies by status:
+          #
+          #   - **sent**: `Message for {recipient} accepted by {ip}:{port} ({hostname})`
+          #   - **softfail/hardfail**:
+          #     `{code} {classification}: Delivery to {recipient} failed at {ip}:{port} ({hostname})`
           #
           #   @return [String, nil]
           optional :details, String
 
           # @!attribute output
-          #   SMTP server response from the receiving mail server
+          #   Raw SMTP response from the receiving mail server
           #
           #   @return [String, nil]
           optional :output, String
 
+          # @!attribute remote_host
+          #   Hostname of the remote mail server that processed the delivery. Present for all
+          #   delivery attempts (successful and failed).
+          #
+          #   @return [String, nil]
+          optional :remote_host, String, api_name: :remoteHost, nil?: true
+
           # @!attribute sent_with_ssl
           #   Whether TLS was used
           #
           #   @return [Boolean, nil]
           optional :sent_with_ssl, ArkEmail::Internal::Type::Boolean, api_name: :sentWithSsl
 
-          # @!method initialize(id:, status:, timestamp:, timestamp_iso:, code: nil, details: nil, output: nil, sent_with_ssl: nil)
+          # @!attribute smtp_enhanced_code
+          #   RFC 3463 enhanced status code from SMTP response (e.g., "5.1.1", "4.2.2"). First
+          #   digit: 2=success, 4=temporary, 5=permanent. Second digit: category (1=address,
+          #   2=mailbox, 7=security, etc.).
+          #
+          #   @return [String, nil]
+          optional :smtp_enhanced_code, String, api_name: :smtpEnhancedCode, nil?: true
+
+          # @!method initialize(id:, status:, timestamp:, timestamp_iso:, classification: nil, classification_code: nil, code: nil, details: nil, output: nil, remote_host: nil, sent_with_ssl: nil, smtp_enhanced_code: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {ArkEmail::Models::EmailRetrieveResponse::Data::Delivery} for more details.
+          #
           #   @param id [String] Delivery attempt ID
           #
           #   @param status [String] Delivery status (lowercase)
@@ -437,13 +478,46 @@ module ArkEmail
           #
           #   @param timestamp_iso [Time] ISO 8601 timestamp
           #
+          #   @param classification [Symbol, ArkEmail::Models::EmailRetrieveResponse::Data::Delivery::Classification, nil] Bounce classification category (present for failed deliveries).
+          #
+          #   @param classification_code [Integer, nil] Numeric bounce classification code for programmatic handling.
+          #
           #   @param code [Integer] SMTP response code
           #
-          #   @param details [String] Status details
+          #   @param details [String] Human-readable delivery summary. Format varies by status:
           #
-          #   @param output [String] SMTP server response from the receiving mail server
+          #   @param output [String] Raw SMTP response from the receiving mail server
+          #
+          #   @param remote_host [String, nil] Hostname of the remote mail server that processed the delivery.
           #
           #   @param sent_with_ssl [Boolean] Whether TLS was used
+          #
+          #   @param smtp_enhanced_code [String, nil] RFC 3463 enhanced status code from SMTP response (e.g., "5.1.1", "4.2.2").
+
+          # Bounce classification category (present for failed deliveries). Helps understand
+          # why delivery failed for analytics and automated handling.
+          #
+          # @see ArkEmail::Models::EmailRetrieveResponse::Data::Delivery#classification
+          module Classification
+            extend ArkEmail::Internal::Type::Enum
+
+            INVALID_RECIPIENT = :invalid_recipient
+            MAILBOX_FULL = :mailbox_full
+            MESSAGE_TOO_LARGE = :message_too_large
+            SPAM_BLOCK = :spam_block
+            POLICY_VIOLATION = :policy_violation
+            NO_MAILBOX = :no_mailbox
+            NOT_ACCEPTING_MAIL = :not_accepting_mail
+            TEMPORARILY_UNAVAILABLE = :temporarily_unavailable
+            PROTOCOL_ERROR = :protocol_error
+            TLS_REQUIRED = :tls_required
+            CONNECTION_ERROR = :connection_error
+            DNS_ERROR = :dns_error
+            UNCLASSIFIED = :unclassified
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/ark_email/models/tenant.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#list
+    class Tenant < ArkEmail::Internal::Type::BaseModel
+      # @!attribute id
+      #   Unique identifier for the tenant
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #   When the tenant was created
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute metadata
+      #   Custom key-value pairs for storing additional data
+      #
+      #   @return [Hash{Symbol=>String, Float, Boolean, nil}]
+      required :metadata, -> { ArkEmail::Internal::Type::HashOf[union: ArkEmail::Tenant::Metadata, nil?: true] }
+
+      # @!attribute name
+      #   Display name for the tenant
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute status
+      #   Current status of the tenant:
+      #
+      #   - `active` - Normal operation
+      #   - `suspended` - Temporarily disabled
+      #   - `archived` - Soft-deleted
+      #
+      #   @return [Symbol, ArkEmail::Models::Tenant::Status]
+      required :status, enum: -> { ArkEmail::Tenant::Status }
+
+      # @!attribute updated_at
+      #   When the tenant was last updated
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!method initialize(id:, created_at:, metadata:, name:, status:, updated_at:)
+      #   Some parameter documentations has been truncated, see {ArkEmail::Models::Tenant}
+      #   for more details.
+      #
+      #   @param id [String] Unique identifier for the tenant
+      #
+      #   @param created_at [Time] When the tenant was created
+      #
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean, nil}] Custom key-value pairs for storing additional data
+      #
+      #   @param name [String] Display name for the tenant
+      #
+      #   @param status [Symbol, ArkEmail::Models::Tenant::Status] Current status of the tenant:
+      #
+      #   @param updated_at [Time] When the tenant was last updated
+
+      module Metadata
+        extend ArkEmail::Internal::Type::Union
+
+        variant String
+
+        variant Float
+
+        variant ArkEmail::Internal::Type::Boolean
+
+        # @!method self.variants
+        #   @return [Array(String, Float, Boolean)]
+      end
+
+      # Current status of the tenant:
+      #
+      # - `active` - Normal operation
+      # - `suspended` - Temporarily disabled
+      # - `archived` - Soft-deleted
+      #
+      # @see ArkEmail::Models::Tenant#status
+      module Status
+        extend ArkEmail::Internal::Type::Enum
+
+        ACTIVE = :active
+        SUSPENDED = :suspended
+        ARCHIVED = :archived
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/ark_email/models/tenant_create_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#create
+    class TenantCreateParams < ArkEmail::Internal::Type::BaseModel
+      extend ArkEmail::Internal::Type::RequestParameters::Converter
+      include ArkEmail::Internal::Type::RequestParameters
+
+      # @!attribute name
+      #   Display name for the tenant (e.g., your customer's company name)
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute metadata
+      #   Custom key-value pairs. Useful for storing references to your internal systems.
+      #
+      #   **Limits:**
+      #
+      #   - Max 50 keys
+      #   - Key names max 40 characters
+      #   - String values max 500 characters
+      #   - Total size max 8KB
+      #
+      #   @return [Hash{Symbol=>String, Float, Boolean, nil}, nil]
+      optional :metadata,
+               -> {
+                 ArkEmail::Internal::Type::HashOf[union: ArkEmail::TenantCreateParams::Metadata, nil?: true]
+               },
+               nil?: true
+
+      # @!method initialize(name:, metadata: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ArkEmail::Models::TenantCreateParams} for more details.
+      #
+      #   @param name [String] Display name for the tenant (e.g., your customer's company name)
+      #
+      #   @param metadata [Hash{Symbol=>String, Float, Boolean, nil}, nil] Custom key-value pairs. Useful for storing references to your internal systems.
+      #
+      #   @param request_options [ArkEmail::RequestOptions, Hash{Symbol=>Object}]
+
+      module Metadata
+        extend ArkEmail::Internal::Type::Union
+
+        variant String
+
+        variant Float
+
+        variant ArkEmail::Internal::Type::Boolean
+
+        # @!method self.variants
+        #   @return [Array(String, Float, Boolean)]
+      end
+    end
+  end
+end

data/lib/ark_email/models/tenant_create_response.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#create
+    class TenantCreateResponse < ArkEmail::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [ArkEmail::Models::Tenant]
+      required :data, -> { ArkEmail::Tenant }
+
+      # @!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)
+      #   @param data [ArkEmail::Models::Tenant]
+      #   @param meta [ArkEmail::Models::APIMeta]
+      #   @param success [Boolean, true]
+    end
+  end
+end

data/lib/ark_email/models/tenant_delete_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#delete
+    class TenantDeleteParams < ArkEmail::Internal::Type::BaseModel
+      extend ArkEmail::Internal::Type::RequestParameters::Converter
+      include ArkEmail::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [ArkEmail::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/ark_email/models/tenant_delete_response.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#delete
+    class TenantDeleteResponse < ArkEmail::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [ArkEmail::Models::TenantDeleteResponse::Data]
+      required :data, -> { ArkEmail::Models::TenantDeleteResponse::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)
+      #   @param data [ArkEmail::Models::TenantDeleteResponse::Data]
+      #   @param meta [ArkEmail::Models::APIMeta]
+      #   @param success [Boolean, true]
+
+      # @see ArkEmail::Models::TenantDeleteResponse#data
+      class Data < ArkEmail::Internal::Type::BaseModel
+        # @!attribute deleted
+        #
+        #   @return [Boolean, true]
+        required :deleted, const: true
+
+        # @!method initialize(deleted: true)
+        #   @param deleted [Boolean, true]
+      end
+    end
+  end
+end

data/lib/ark_email/models/tenant_list_params.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#list
+    class TenantListParams < ArkEmail::Internal::Type::BaseModel
+      extend ArkEmail::Internal::Type::RequestParameters::Converter
+      include ArkEmail::Internal::Type::RequestParameters
+
+      # @!attribute page
+      #   Page number (1-indexed)
+      #
+      #   @return [Integer, nil]
+      optional :page, Integer
+
+      # @!attribute per_page
+      #   Number of items per page (max 100)
+      #
+      #   @return [Integer, nil]
+      optional :per_page, Integer
+
+      # @!attribute status
+      #   Filter by tenant status
+      #
+      #   @return [Symbol, ArkEmail::Models::TenantListParams::Status, nil]
+      optional :status, enum: -> { ArkEmail::TenantListParams::Status }
+
+      # @!method initialize(page: nil, per_page: nil, status: nil, request_options: {})
+      #   @param page [Integer] Page number (1-indexed)
+      #
+      #   @param per_page [Integer] Number of items per page (max 100)
+      #
+      #   @param status [Symbol, ArkEmail::Models::TenantListParams::Status] Filter by tenant status
+      #
+      #   @param request_options [ArkEmail::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by tenant status
+      module Status
+        extend ArkEmail::Internal::Type::Enum
+
+        ACTIVE = :active
+        SUSPENDED = :suspended
+        ARCHIVED = :archived
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/ark_email/models/tenant_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#retrieve
+    class TenantRetrieveParams < ArkEmail::Internal::Type::BaseModel
+      extend ArkEmail::Internal::Type::RequestParameters::Converter
+      include ArkEmail::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [ArkEmail::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/ark_email/models/tenant_retrieve_response.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module ArkEmail
+  module Models
+    # @see ArkEmail::Resources::Tenants#retrieve
+    class TenantRetrieveResponse < ArkEmail::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [ArkEmail::Models::Tenant]
+      required :data, -> { ArkEmail::Tenant }
+
+      # @!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)
+      #   @param data [ArkEmail::Models::Tenant]
+      #   @param meta [ArkEmail::Models::APIMeta]
+      #   @param success [Boolean, true]
+    end
+  end
+end