ark-email 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee70352e87d7586234884d318276da0a01b94c7a8cc47e795d37fa77571a0d17
-  data.tar.gz: f469a30b7c8ed720169c6b6c613eb8279789e82505581d1584d930c67d678784
+  metadata.gz: d612dc78e03726f7930429ab6d7cf9826145b9bf42d5049e8a5ecea9db3ad7b8
+  data.tar.gz: 33a733a57efb4084871fde7e35c7913c836eecc708a40af1210171f91de390c7
 SHA512:
-  metadata.gz: 176ab6feb912821c518e32aea92ff9c3b7acf82e25ef4382aca2a9101bc1f5339c2bd9e76f89c9cf6e0feb0313a635101ddb5169b70232f2fa68a046f279cdf2
-  data.tar.gz: 9244988b7e44d174dd35d7b0f005574b37acd10aae831db4170c15725d00d7c22d37ab705f5f7cfbfe49e199f2f74b40680e055c3f52edf7ebd9b92832b71396
+  metadata.gz: 4487eebe13f6bc9f8589ae754827ea7f0a62a9796964a1f938272f16b1dadce28b49efb4d836ab90b0d68742c2bfc3eca6b3ec4376df87255c56db9f75301dee
+  data.tar.gz: 3f9798c5f37e08efcbdc8f6723258412fe55f91bcb1f71b7440d204d1b5800ce75acbc6b0c0e7192c73b742b3729e343013869c3758fb1e44a399f8787ef0020

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.11.0 (2026-01-22)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** api update ([451702c](https://github.com/ArkHQ-io/ark-ruby/commit/451702c378dd03df067d91d5a6b86b5c3af6e1d5))
+* **api:** api update ([94327b4](https://github.com/ArkHQ-io/ark-ruby/commit/94327b43c646e4bf7d8ae97a6f9702d8e3768953))
+* **api:** fix incorrect webhook payload examples ([09c481a](https://github.com/ArkHQ-io/ark-ruby/commit/09c481add3ef93c3c494403d0abce3fd09a1083d))
+* **api:** manual updates ([d166dbe](https://github.com/ArkHQ-io/ark-ruby/commit/d166dbebf3aa3218cf3488cabadb957012114d01))
+
+## 0.10.0 (2026-01-22)
+
+Full Changelog: [v0.9.0...v0.10.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.9.0...v0.10.0)
+
+### Features
+
+* **api:** improve GET delivery attempts ([863df8e](https://github.com/ArkHQ-io/ark-ruby/commit/863df8e1ca7e4e29f44fdd1ffb9583fc71e5245e))
+
 ## 0.9.0 (2026-01-21)
 
 Full Changelog: [v0.8.0...v0.9.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.8.0...v0.9.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.9.0"
+gem "ark-email", "~> 0.11.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/ark_email/models/email_retrieve_deliveries_response.rb

@@ -26,30 +26,72 @@ module ArkEmail
 
       # @see ArkEmail::Models::EmailRetrieveDeliveriesResponse#data
       class Data < ArkEmail::Internal::Type::BaseModel
+        # @!attribute can_retry_manually
+        #   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.
+        #
+        #   @return [Boolean]
+        required :can_retry_manually, ArkEmail::Internal::Type::Boolean, api_name: :canRetryManually
+
         # @!attribute deliveries
+        #   Chronological list of delivery attempts for this message. Each attempt includes
+        #   SMTP response codes and timestamps.
         #
         #   @return [Array<ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery>]
         required :deliveries,
                  -> { ArkEmail::Internal::Type::ArrayOf[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery] }
 
         # @!attribute message_id
-        #   Internal message ID
+        #   Internal numeric message ID
         #
-        #   @return [String]
-        required :message_id, String, api_name: :messageId
+        #   @return [Integer]
+        required :message_id, Integer, api_name: :messageId
 
         # @!attribute message_token
-        #   Message token
+        #   Unique message token for API references
         #
         #   @return [String]
         required :message_token, String, api_name: :messageToken
 
-        # @!method initialize(deliveries:, message_id:, message_token:)
-        #   @param deliveries [Array<ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery>]
+        # @!attribute retry_state
+        #   Information about the current retry state of a message that is queued for
+        #   delivery. Only present when the message is in the delivery queue.
         #
-        #   @param message_id [String] Internal message ID
+        #   @return [ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState, nil]
+        required :retry_state,
+                 -> { ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState },
+                 api_name: :retryState,
+                 nil?: true
+
+        # @!attribute status
+        #   Current message status (lowercase). Possible values:
+        #
+        #   - `pending` - Initial state, awaiting first delivery attempt
+        #   - `sent` - Successfully delivered
+        #   - `softfail` - Temporary failure, will retry automatically
+        #   - `hardfail` - Permanent failure, will not retry
+        #   - `held` - Held for manual review (suppression list, etc.)
+        #   - `bounced` - Bounced by recipient server
         #
-        #   @param message_token [String] Message token
+        #   @return [Symbol, ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status]
+        required :status, enum: -> { ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status }
+
+        # @!method initialize(can_retry_manually:, deliveries:, message_id:, message_token:, retry_state:, status:)
+        #   Some parameter documentations has been truncated, see
+        #   {ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data} for more details.
+        #
+        #   @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.
+        #
+        #   @param message_id [Integer] Internal numeric message ID
+        #
+        #   @param message_token [String] Unique message token for API references
+        #
+        #   @param retry_state [ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState, nil] Information about the current retry state of a message that is queued for delive
+        #
+        #   @param status [Symbol, ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status] Current message status (lowercase). Possible values:
 
         class Delivery < ArkEmail::Internal::Type::BaseModel
           # @!attribute id
@@ -117,6 +159,104 @@ module ArkEmail
           #
           #   @param sent_with_ssl [Boolean] Whether TLS was used
         end
+
+        # @see ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data#retry_state
+        class RetryState < ArkEmail::Internal::Type::BaseModel
+          # @!attribute attempt
+          #   Current attempt number (0-indexed). The first delivery attempt is 0, the first
+          #   retry is 1, and so on.
+          #
+          #   @return [Integer]
+          required :attempt, Integer
+
+          # @!attribute attempts_remaining
+          #   Number of attempts remaining before the message is hard-failed. Calculated as
+          #   `maxAttempts - attempt`.
+          #
+          #   @return [Integer]
+          required :attempts_remaining, Integer, api_name: :attemptsRemaining
+
+          # @!attribute manual
+          #   Whether this queue entry was created by a manual retry request. Manual retries
+          #   bypass certain hold conditions like suppression lists.
+          #
+          #   @return [Boolean]
+          required :manual, ArkEmail::Internal::Type::Boolean
+
+          # @!attribute max_attempts
+          #   Maximum number of delivery attempts before the message is hard-failed.
+          #   Configured at the server level.
+          #
+          #   @return [Integer]
+          required :max_attempts, Integer, api_name: :maxAttempts
+
+          # @!attribute processing
+          #   Whether the message is currently being processed by a delivery worker. When
+          #   `true`, the message is actively being sent.
+          #
+          #   @return [Boolean]
+          required :processing, ArkEmail::Internal::Type::Boolean
+
+          # @!attribute next_retry_at
+          #   Unix timestamp of when the next retry attempt is scheduled. `null` if the
+          #   message is ready for immediate processing or currently being processed.
+          #
+          #   @return [Float, nil]
+          optional :next_retry_at, Float, api_name: :nextRetryAt, nil?: true
+
+          # @!attribute next_retry_at_iso
+          #   ISO 8601 formatted timestamp of the next retry attempt. `null` if the message is
+          #   ready for immediate processing.
+          #
+          #   @return [Time, nil]
+          optional :next_retry_at_iso, Time, api_name: :nextRetryAtIso, nil?: true
+
+          # @!method initialize(attempt:, attempts_remaining:, manual:, max_attempts:, processing:, next_retry_at: nil, next_retry_at_iso: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState} for more
+          #   details.
+          #
+          #   Information about the current retry state of a message that is queued for
+          #   delivery. Only present when the message is in the delivery queue.
+          #
+          #   @param attempt [Integer] Current attempt number (0-indexed). The first delivery attempt is 0,
+          #
+          #   @param attempts_remaining [Integer] Number of attempts remaining before the message is hard-failed.
+          #
+          #   @param manual [Boolean] Whether this queue entry was created by a manual retry request.
+          #
+          #   @param max_attempts [Integer] Maximum number of delivery attempts before the message is hard-failed.
+          #
+          #   @param processing [Boolean] Whether the message is currently being processed by a delivery worker.
+          #
+          #   @param next_retry_at [Float, nil] Unix timestamp of when the next retry attempt is scheduled.
+          #
+          #   @param next_retry_at_iso [Time, nil] ISO 8601 formatted timestamp of the next retry attempt.
+        end
+
+        # Current message status (lowercase). Possible values:
+        #
+        # - `pending` - Initial state, awaiting first delivery attempt
+        # - `sent` - Successfully delivered
+        # - `softfail` - Temporary failure, will retry automatically
+        # - `hardfail` - Permanent failure, will not retry
+        # - `held` - Held for manual review (suppression list, etc.)
+        # - `bounced` - Bounced by recipient server
+        #
+        # @see ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data#status
+        module Status
+          extend ArkEmail::Internal::Type::Enum
+
+          PENDING = :pending
+          SENT = :sent
+          SOFTFAIL = :softfail
+          HARDFAIL = :hardfail
+          HELD = :held
+          BOUNCED = :bounced
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/ark_email/models/webhook_create_params.rb

@@ -75,6 +75,8 @@ module ArkEmail
         MESSAGE_LINK_CLICKED = :MessageLinkClicked
         MESSAGE_LOADED = :MessageLoaded
         DOMAIN_DNS_ERROR = :DomainDNSError
+        SEND_LIMIT_APPROACHING = :SendLimitApproaching
+        SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/ark_email/models/webhook_create_response.rb

@@ -101,6 +101,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED = :MessageLinkClicked
           MESSAGE_LOADED = :MessageLoaded
           DOMAIN_DNS_ERROR = :DomainDNSError
+          SEND_LIMIT_APPROACHING = :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/ark_email/models/webhook_list_deliveries_params.rb

@@ -70,6 +70,8 @@ module ArkEmail
         MESSAGE_LINK_CLICKED = :MessageLinkClicked
         MESSAGE_LOADED = :MessageLoaded
         DOMAIN_DNS_ERROR = :DomainDNSError
+        SEND_LIMIT_APPROACHING = :SendLimitApproaching
+        SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/ark_email/models/webhook_list_deliveries_response.rb

@@ -144,6 +144,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED = :MessageLinkClicked
           MESSAGE_LOADED = :MessageLoaded
           DOMAIN_DNS_ERROR = :DomainDNSError
+          SEND_LIMIT_APPROACHING = :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/ark_email/models/webhook_retrieve_delivery_response.rb

@@ -144,6 +144,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED = :MessageLinkClicked
           MESSAGE_LOADED = :MessageLoaded
           DOMAIN_DNS_ERROR = :DomainDNSError
+          SEND_LIMIT_APPROACHING = :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/ark_email/models/webhook_retrieve_response.rb

@@ -101,6 +101,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED = :MessageLinkClicked
           MESSAGE_LOADED = :MessageLoaded
           DOMAIN_DNS_ERROR = :DomainDNSError
+          SEND_LIMIT_APPROACHING = :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/ark_email/models/webhook_test_params.rb

@@ -30,6 +30,8 @@ module ArkEmail
         MESSAGE_LINK_CLICKED = :MessageLinkClicked
         MESSAGE_LOADED = :MessageLoaded
         DOMAIN_DNS_ERROR = :DomainDNSError
+        SEND_LIMIT_APPROACHING = :SendLimitApproaching
+        SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/ark_email/models/webhook_update_response.rb

@@ -101,6 +101,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED = :MessageLinkClicked
           MESSAGE_LOADED = :MessageLoaded
           DOMAIN_DNS_ERROR = :DomainDNSError
+          SEND_LIMIT_APPROACHING = :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED = :SendLimitExceeded
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/ark_email/resources/emails.rb

@@ -82,12 +82,50 @@ module ArkEmail
         )
       end
 
-      # Get the history of delivery attempts for an email, including SMTP response codes
-      # and timestamps.
+      # Some parameter documentations has been truncated, see
+      # {ArkEmail::Models::EmailRetrieveDeliveriesParams} for more details.
+      #
+      # Get the complete delivery history for an email, including SMTP response codes,
+      # timestamps, and current retry state.
+      #
+      # ## Response Fields
+      #
+      # ### Status
+      #
+      # The current status of the email:
+      #
+      # - `pending` - Awaiting first delivery attempt
+      # - `sent` - Successfully delivered to recipient server
+      # - `softfail` - Temporary failure, automatic retry scheduled
+      # - `hardfail` - Permanent failure, will not retry
+      # - `held` - Held for manual review
+      # - `bounced` - Bounced by recipient server
+      #
+      # ### Retry State
+      #
+      # When the email is in the delivery queue (`pending` or `softfail` status),
+      # `retryState` provides information about the retry schedule:
+      #
+      # - `attempt` - Current attempt number (0 = first attempt)
+      # - `maxAttempts` - Maximum attempts before hard-fail (typically 18)
+      # - `attemptsRemaining` - Attempts left before hard-fail
+      # - `nextRetryAt` - When the next retry is scheduled (Unix timestamp)
+      # - `processing` - Whether the email is currently being processed
+      # - `manual` - Whether this was triggered by a manual retry
+      #
+      # When the email has finished processing (`sent`, `hardfail`, `held`, `bounced`),
+      # `retryState` is `null`.
+      #
+      # ### Can Retry Manually
+      #
+      # Indicates whether you can call `POST /emails/{emailId}/retry` to manually retry
+      # the email. This is `true` when the raw message content is still available (not
+      # expired due to retention policy).
       #
       # @overload retrieve_deliveries(email_id, request_options: {})
       #
-      # @param email_id [String]
+      # @param email_id [String] Email identifier. Accepts multiple formats:
+      #
       # @param request_options [ArkEmail::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ArkEmail::Models::EmailRetrieveDeliveriesResponse]

data/lib/ark_email/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ArkEmail
-  VERSION = "0.9.0"
+  VERSION = "0.11.0"
 end

data/rbi/ark_email/models/email_retrieve_deliveries_response.rbi

@@ -61,6 +61,14 @@ module ArkEmail
             )
           end
 
+        # 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.
+        sig { returns(T::Boolean) }
+        attr_accessor :can_retry_manually
+
+        # Chronological list of delivery attempts for this message. Each attempt includes
+        # SMTP response codes and timestamps.
         sig do
           returns(
             T::Array[
@@ -70,42 +78,110 @@ module ArkEmail
         end
         attr_accessor :deliveries
 
-        # Internal message ID
-        sig { returns(String) }
+        # Internal numeric message ID
+        sig { returns(Integer) }
         attr_accessor :message_id
 
-        # Message token
+        # Unique message token for API references
         sig { returns(String) }
         attr_accessor :message_token
 
+        # Information about the current retry state of a message that is queued for
+        # delivery. Only present when the message is in the delivery queue.
+        sig do
+          returns(
+            T.nilable(
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState
+            )
+          )
+        end
+        attr_reader :retry_state
+
+        sig do
+          params(
+            retry_state:
+              T.nilable(
+                ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState::OrHash
+              )
+          ).void
+        end
+        attr_writer :retry_state
+
+        # Current message status (lowercase). Possible values:
+        #
+        # - `pending` - Initial state, awaiting first delivery attempt
+        # - `sent` - Successfully delivered
+        # - `softfail` - Temporary failure, will retry automatically
+        # - `hardfail` - Permanent failure, will not retry
+        # - `held` - Held for manual review (suppression list, etc.)
+        # - `bounced` - Bounced by recipient server
+        sig do
+          returns(
+            ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
         sig do
           params(
+            can_retry_manually: T::Boolean,
             deliveries:
               T::Array[
                 ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery::OrHash
               ],
-            message_id: String,
-            message_token: String
+            message_id: Integer,
+            message_token: String,
+            retry_state:
+              T.nilable(
+                ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState::OrHash
+              ),
+            status:
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::OrSymbol
           ).returns(T.attached_class)
         end
         def self.new(
+          # 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.
+          can_retry_manually:,
+          # Chronological list of delivery attempts for this message. Each attempt includes
+          # SMTP response codes and timestamps.
           deliveries:,
-          # Internal message ID
+          # Internal numeric message ID
           message_id:,
-          # Message token
-          message_token:
+          # Unique message token for API references
+          message_token:,
+          # Information about the current retry state of a message that is queued for
+          # delivery. Only present when the message is in the delivery queue.
+          retry_state:,
+          # Current message status (lowercase). Possible values:
+          #
+          # - `pending` - Initial state, awaiting first delivery attempt
+          # - `sent` - Successfully delivered
+          # - `softfail` - Temporary failure, will retry automatically
+          # - `hardfail` - Permanent failure, will not retry
+          # - `held` - Held for manual review (suppression list, etc.)
+          # - `bounced` - Bounced by recipient server
+          status:
         )
         end
 
         sig do
           override.returns(
             {
+              can_retry_manually: T::Boolean,
               deliveries:
                 T::Array[
                   ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery
                 ],
-              message_id: String,
-              message_token: String
+              message_id: Integer,
+              message_token: String,
+              retry_state:
+                T.nilable(
+                  ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState
+                ),
+              status:
+                ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
             }
           )
         end
@@ -214,6 +290,167 @@ module ArkEmail
           def to_hash
           end
         end
+
+        class RetryState < ArkEmail::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState,
+                ArkEmail::Internal::AnyHash
+              )
+            end
+
+          # Current attempt number (0-indexed). The first delivery attempt is 0, the first
+          # retry is 1, and so on.
+          sig { returns(Integer) }
+          attr_accessor :attempt
+
+          # Number of attempts remaining before the message is hard-failed. Calculated as
+          # `maxAttempts - attempt`.
+          sig { returns(Integer) }
+          attr_accessor :attempts_remaining
+
+          # Whether this queue entry was created by a manual retry request. Manual retries
+          # bypass certain hold conditions like suppression lists.
+          sig { returns(T::Boolean) }
+          attr_accessor :manual
+
+          # Maximum number of delivery attempts before the message is hard-failed.
+          # Configured at the server level.
+          sig { returns(Integer) }
+          attr_accessor :max_attempts
+
+          # Whether the message is currently being processed by a delivery worker. When
+          # `true`, the message is actively being sent.
+          sig { returns(T::Boolean) }
+          attr_accessor :processing
+
+          # Unix timestamp of when the next retry attempt is scheduled. `null` if the
+          # message is ready for immediate processing or currently being processed.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :next_retry_at
+
+          # ISO 8601 formatted timestamp of the next retry attempt. `null` if the message is
+          # ready for immediate processing.
+          sig { returns(T.nilable(Time)) }
+          attr_accessor :next_retry_at_iso
+
+          # Information about the current retry state of a message that is queued for
+          # delivery. Only present when the message is in the delivery queue.
+          sig do
+            params(
+              attempt: Integer,
+              attempts_remaining: Integer,
+              manual: T::Boolean,
+              max_attempts: Integer,
+              processing: T::Boolean,
+              next_retry_at: T.nilable(Float),
+              next_retry_at_iso: T.nilable(Time)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Current attempt number (0-indexed). The first delivery attempt is 0, the first
+            # retry is 1, and so on.
+            attempt:,
+            # Number of attempts remaining before the message is hard-failed. Calculated as
+            # `maxAttempts - attempt`.
+            attempts_remaining:,
+            # Whether this queue entry was created by a manual retry request. Manual retries
+            # bypass certain hold conditions like suppression lists.
+            manual:,
+            # Maximum number of delivery attempts before the message is hard-failed.
+            # Configured at the server level.
+            max_attempts:,
+            # Whether the message is currently being processed by a delivery worker. When
+            # `true`, the message is actively being sent.
+            processing:,
+            # Unix timestamp of when the next retry attempt is scheduled. `null` if the
+            # message is ready for immediate processing or currently being processed.
+            next_retry_at: nil,
+            # ISO 8601 formatted timestamp of the next retry attempt. `null` if the message is
+            # ready for immediate processing.
+            next_retry_at_iso: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                attempt: Integer,
+                attempts_remaining: Integer,
+                manual: T::Boolean,
+                max_attempts: Integer,
+                processing: T::Boolean,
+                next_retry_at: T.nilable(Float),
+                next_retry_at_iso: T.nilable(Time)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+
+        # Current message status (lowercase). Possible values:
+        #
+        # - `pending` - Initial state, awaiting first delivery attempt
+        # - `sent` - Successfully delivered
+        # - `softfail` - Temporary failure, will retry automatically
+        # - `hardfail` - Permanent failure, will not retry
+        # - `held` - Held for manual review (suppression list, etc.)
+        # - `bounced` - Bounced by recipient server
+        module Status
+          extend ArkEmail::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PENDING =
+            T.let(
+              :pending,
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+            )
+          SENT =
+            T.let(
+              :sent,
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+            )
+          SOFTFAIL =
+            T.let(
+              :softfail,
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+            )
+          HARDFAIL =
+            T.let(
+              :hardfail,
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+            )
+          HELD =
+            T.let(
+              :held,
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+            )
+          BOUNCED =
+            T.let(
+              :bounced,
+              ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/ark_email/models/webhook_create_params.rbi

@@ -144,6 +144,16 @@ module ArkEmail
             :DomainDNSError,
             ArkEmail::WebhookCreateParams::Event::TaggedSymbol
           )
+        SEND_LIMIT_APPROACHING =
+          T.let(
+            :SendLimitApproaching,
+            ArkEmail::WebhookCreateParams::Event::TaggedSymbol
+          )
+        SEND_LIMIT_EXCEEDED =
+          T.let(
+            :SendLimitExceeded,
+            ArkEmail::WebhookCreateParams::Event::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/ark_email/models/webhook_create_response.rbi

@@ -200,6 +200,16 @@ module ArkEmail
               :DomainDNSError,
               ArkEmail::Models::WebhookCreateResponse::Data::Event::TaggedSymbol
             )
+          SEND_LIMIT_APPROACHING =
+            T.let(
+              :SendLimitApproaching,
+              ArkEmail::Models::WebhookCreateResponse::Data::Event::TaggedSymbol
+            )
+          SEND_LIMIT_EXCEEDED =
+            T.let(
+              :SendLimitExceeded,
+              ArkEmail::Models::WebhookCreateResponse::Data::Event::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/ark_email/models/webhook_list_deliveries_params.rbi

@@ -158,6 +158,16 @@ module ArkEmail
             :DomainDNSError,
             ArkEmail::WebhookListDeliveriesParams::Event::TaggedSymbol
           )
+        SEND_LIMIT_APPROACHING =
+          T.let(
+            :SendLimitApproaching,
+            ArkEmail::WebhookListDeliveriesParams::Event::TaggedSymbol
+          )
+        SEND_LIMIT_EXCEEDED =
+          T.let(
+            :SendLimitExceeded,
+            ArkEmail::WebhookListDeliveriesParams::Event::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/ark_email/models/webhook_list_deliveries_response.rbi

@@ -240,6 +240,16 @@ module ArkEmail
               :DomainDNSError,
               ArkEmail::Models::WebhookListDeliveriesResponse::Data::Event::TaggedSymbol
             )
+          SEND_LIMIT_APPROACHING =
+            T.let(
+              :SendLimitApproaching,
+              ArkEmail::Models::WebhookListDeliveriesResponse::Data::Event::TaggedSymbol
+            )
+          SEND_LIMIT_EXCEEDED =
+            T.let(
+              :SendLimitExceeded,
+              ArkEmail::Models::WebhookListDeliveriesResponse::Data::Event::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/ark_email/models/webhook_retrieve_delivery_response.rbi

@@ -269,6 +269,16 @@ module ArkEmail
               :DomainDNSError,
               ArkEmail::Models::WebhookRetrieveDeliveryResponse::Data::Event::TaggedSymbol
             )
+          SEND_LIMIT_APPROACHING =
+            T.let(
+              :SendLimitApproaching,
+              ArkEmail::Models::WebhookRetrieveDeliveryResponse::Data::Event::TaggedSymbol
+            )
+          SEND_LIMIT_EXCEEDED =
+            T.let(
+              :SendLimitExceeded,
+              ArkEmail::Models::WebhookRetrieveDeliveryResponse::Data::Event::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/ark_email/models/webhook_retrieve_response.rbi

@@ -202,6 +202,16 @@ module ArkEmail
               :DomainDNSError,
               ArkEmail::Models::WebhookRetrieveResponse::Data::Event::TaggedSymbol
             )
+          SEND_LIMIT_APPROACHING =
+            T.let(
+              :SendLimitApproaching,
+              ArkEmail::Models::WebhookRetrieveResponse::Data::Event::TaggedSymbol
+            )
+          SEND_LIMIT_EXCEEDED =
+            T.let(
+              :SendLimitExceeded,
+              ArkEmail::Models::WebhookRetrieveResponse::Data::Event::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/ark_email/models/webhook_test_params.rbi

@@ -81,6 +81,16 @@ module ArkEmail
             :DomainDNSError,
             ArkEmail::WebhookTestParams::Event::TaggedSymbol
           )
+        SEND_LIMIT_APPROACHING =
+          T.let(
+            :SendLimitApproaching,
+            ArkEmail::WebhookTestParams::Event::TaggedSymbol
+          )
+        SEND_LIMIT_EXCEEDED =
+          T.let(
+            :SendLimitExceeded,
+            ArkEmail::WebhookTestParams::Event::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/ark_email/models/webhook_update_response.rbi

@@ -200,6 +200,16 @@ module ArkEmail
               :DomainDNSError,
               ArkEmail::Models::WebhookUpdateResponse::Data::Event::TaggedSymbol
             )
+          SEND_LIMIT_APPROACHING =
+            T.let(
+              :SendLimitApproaching,
+              ArkEmail::Models::WebhookUpdateResponse::Data::Event::TaggedSymbol
+            )
+          SEND_LIMIT_EXCEEDED =
+            T.let(
+              :SendLimitExceeded,
+              ArkEmail::Models::WebhookUpdateResponse::Data::Event::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/ark_email/resources/emails.rbi

@@ -83,15 +83,57 @@ module ArkEmail
       )
       end
 
-      # Get the history of delivery attempts for an email, including SMTP response codes
-      # and timestamps.
+      # Get the complete delivery history for an email, including SMTP response codes,
+      # timestamps, and current retry state.
+      #
+      # ## Response Fields
+      #
+      # ### Status
+      #
+      # The current status of the email:
+      #
+      # - `pending` - Awaiting first delivery attempt
+      # - `sent` - Successfully delivered to recipient server
+      # - `softfail` - Temporary failure, automatic retry scheduled
+      # - `hardfail` - Permanent failure, will not retry
+      # - `held` - Held for manual review
+      # - `bounced` - Bounced by recipient server
+      #
+      # ### Retry State
+      #
+      # When the email is in the delivery queue (`pending` or `softfail` status),
+      # `retryState` provides information about the retry schedule:
+      #
+      # - `attempt` - Current attempt number (0 = first attempt)
+      # - `maxAttempts` - Maximum attempts before hard-fail (typically 18)
+      # - `attemptsRemaining` - Attempts left before hard-fail
+      # - `nextRetryAt` - When the next retry is scheduled (Unix timestamp)
+      # - `processing` - Whether the email is currently being processed
+      # - `manual` - Whether this was triggered by a manual retry
+      #
+      # When the email has finished processing (`sent`, `hardfail`, `held`, `bounced`),
+      # `retryState` is `null`.
+      #
+      # ### Can Retry Manually
+      #
+      # Indicates whether you can call `POST /emails/{emailId}/retry` to manually retry
+      # the email. This is `true` when the raw message content is still available (not
+      # expired due to retention policy).
       sig do
         params(
           email_id: String,
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::EmailRetrieveDeliveriesResponse)
       end
-      def retrieve_deliveries(email_id, request_options: {})
+      def retrieve_deliveries(
+        # Email identifier. Accepts multiple formats:
+        #
+        # - Message ID (numeric): `12345`
+        # - Message token: `aBc123XyZ`
+        # - Combined format: `msg_12345_aBc123XyZ`
+        email_id,
+        request_options: {}
+      )
       end
 
       # Retry delivery of a failed or soft-bounced email. Creates a new delivery

data/sig/ark_email/models/email_retrieve_deliveries_response.rbs

@@ -28,28 +28,43 @@ module ArkEmail
 
       type data =
         {
+          can_retry_manually: bool,
           deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery],
-          message_id: String,
-          message_token: String
+          message_id: Integer,
+          message_token: String,
+          retry_state: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState?,
+          status: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::status
         }
 
       class Data < ArkEmail::Internal::Type::BaseModel
+        attr_accessor can_retry_manually: bool
+
         attr_accessor deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery]
 
-        attr_accessor message_id: String
+        attr_accessor message_id: Integer
 
         attr_accessor message_token: String
 
+        attr_accessor retry_state: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState?
+
+        attr_accessor status: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::status
+
         def initialize: (
+          can_retry_manually: bool,
           deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery],
-          message_id: String,
-          message_token: String
+          message_id: Integer,
+          message_token: String,
+          retry_state: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState?,
+          status: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::status
         ) -> void
 
         def to_hash: -> {
+          can_retry_manually: bool,
           deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery],
-          message_id: String,
-          message_token: String
+          message_id: Integer,
+          message_token: String,
+          retry_state: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState?,
+          status: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::status
         }
 
         type delivery =
@@ -111,6 +126,69 @@ module ArkEmail
             sent_with_ssl: bool
           }
         end
+
+        type retry_state =
+          {
+            attempt: Integer,
+            attempts_remaining: Integer,
+            manual: bool,
+            max_attempts: Integer,
+            processing: bool,
+            next_retry_at: Float?,
+            next_retry_at_iso: Time?
+          }
+
+        class RetryState < ArkEmail::Internal::Type::BaseModel
+          attr_accessor attempt: Integer
+
+          attr_accessor attempts_remaining: Integer
+
+          attr_accessor manual: bool
+
+          attr_accessor max_attempts: Integer
+
+          attr_accessor processing: bool
+
+          attr_accessor next_retry_at: Float?
+
+          attr_accessor next_retry_at_iso: Time?
+
+          def initialize: (
+            attempt: Integer,
+            attempts_remaining: Integer,
+            manual: bool,
+            max_attempts: Integer,
+            processing: bool,
+            ?next_retry_at: Float?,
+            ?next_retry_at_iso: Time?
+          ) -> void
+
+          def to_hash: -> {
+            attempt: Integer,
+            attempts_remaining: Integer,
+            manual: bool,
+            max_attempts: Integer,
+            processing: bool,
+            next_retry_at: Float?,
+            next_retry_at_iso: Time?
+          }
+        end
+
+        type status =
+          :pending | :sent | :softfail | :hardfail | :held | :bounced
+
+        module Status
+          extend ArkEmail::Internal::Type::Enum
+
+          PENDING: :pending
+          SENT: :sent
+          SOFTFAIL: :softfail
+          HARDFAIL: :hardfail
+          HELD: :held
+          BOUNCED: :bounced
+
+          def self?.values: -> ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::status]
+        end
       end
     end
   end

data/sig/ark_email/models/webhook_create_params.rbs

@@ -51,6 +51,8 @@ module ArkEmail
         | :MessageLinkClicked
         | :MessageLoaded
         | :DomainDNSError
+        | :SendLimitApproaching
+        | :SendLimitExceeded
 
       module Event
         extend ArkEmail::Internal::Type::Enum
@@ -63,6 +65,8 @@ module ArkEmail
         MESSAGE_LINK_CLICKED: :MessageLinkClicked
         MESSAGE_LOADED: :MessageLoaded
         DOMAIN_DNS_ERROR: :DomainDNSError
+        SEND_LIMIT_APPROACHING: :SendLimitApproaching
+        SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
         def self?.values: -> ::Array[ArkEmail::Models::WebhookCreateParams::event]
       end

data/sig/ark_email/models/webhook_create_response.rbs

@@ -86,6 +86,8 @@ module ArkEmail
           | :MessageLinkClicked
           | :MessageLoaded
           | :DomainDNSError
+          | :SendLimitApproaching
+          | :SendLimitExceeded
 
         module Event
           extend ArkEmail::Internal::Type::Enum
@@ -98,6 +100,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED: :MessageLinkClicked
           MESSAGE_LOADED: :MessageLoaded
           DOMAIN_DNS_ERROR: :DomainDNSError
+          SEND_LIMIT_APPROACHING: :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
           def self?.values: -> ::Array[ArkEmail::Models::WebhookCreateResponse::Data::event]
         end

data/sig/ark_email/models/webhook_list_deliveries_params.rbs

@@ -70,6 +70,8 @@ module ArkEmail
         | :MessageLinkClicked
         | :MessageLoaded
         | :DomainDNSError
+        | :SendLimitApproaching
+        | :SendLimitExceeded
 
       module Event
         extend ArkEmail::Internal::Type::Enum
@@ -82,6 +84,8 @@ module ArkEmail
         MESSAGE_LINK_CLICKED: :MessageLinkClicked
         MESSAGE_LOADED: :MessageLoaded
         DOMAIN_DNS_ERROR: :DomainDNSError
+        SEND_LIMIT_APPROACHING: :SendLimitApproaching
+        SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
         def self?.values: -> ::Array[ArkEmail::Models::WebhookListDeliveriesParams::event]
       end

data/sig/ark_email/models/webhook_list_deliveries_response.rbs

@@ -106,6 +106,8 @@ module ArkEmail
           | :MessageLinkClicked
           | :MessageLoaded
           | :DomainDNSError
+          | :SendLimitApproaching
+          | :SendLimitExceeded
 
         module Event
           extend ArkEmail::Internal::Type::Enum
@@ -118,6 +120,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED: :MessageLinkClicked
           MESSAGE_LOADED: :MessageLoaded
           DOMAIN_DNS_ERROR: :DomainDNSError
+          SEND_LIMIT_APPROACHING: :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
           def self?.values: -> ::Array[ArkEmail::Models::WebhookListDeliveriesResponse::Data::event]
         end

data/sig/ark_email/models/webhook_retrieve_delivery_response.rbs

@@ -106,6 +106,8 @@ module ArkEmail
           | :MessageLinkClicked
           | :MessageLoaded
           | :DomainDNSError
+          | :SendLimitApproaching
+          | :SendLimitExceeded
 
         module Event
           extend ArkEmail::Internal::Type::Enum
@@ -118,6 +120,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED: :MessageLinkClicked
           MESSAGE_LOADED: :MessageLoaded
           DOMAIN_DNS_ERROR: :DomainDNSError
+          SEND_LIMIT_APPROACHING: :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
           def self?.values: -> ::Array[ArkEmail::Models::WebhookRetrieveDeliveryResponse::Data::event]
         end

data/sig/ark_email/models/webhook_retrieve_response.rbs

@@ -86,6 +86,8 @@ module ArkEmail
           | :MessageLinkClicked
           | :MessageLoaded
           | :DomainDNSError
+          | :SendLimitApproaching
+          | :SendLimitExceeded
 
         module Event
           extend ArkEmail::Internal::Type::Enum
@@ -98,6 +100,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED: :MessageLinkClicked
           MESSAGE_LOADED: :MessageLoaded
           DOMAIN_DNS_ERROR: :DomainDNSError
+          SEND_LIMIT_APPROACHING: :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
           def self?.values: -> ::Array[ArkEmail::Models::WebhookRetrieveResponse::Data::event]
         end

data/sig/ark_email/models/webhook_test_params.rbs

@@ -29,6 +29,8 @@ module ArkEmail
         | :MessageLinkClicked
         | :MessageLoaded
         | :DomainDNSError
+        | :SendLimitApproaching
+        | :SendLimitExceeded
 
       module Event
         extend ArkEmail::Internal::Type::Enum
@@ -41,6 +43,8 @@ module ArkEmail
         MESSAGE_LINK_CLICKED: :MessageLinkClicked
         MESSAGE_LOADED: :MessageLoaded
         DOMAIN_DNS_ERROR: :DomainDNSError
+        SEND_LIMIT_APPROACHING: :SendLimitApproaching
+        SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
         def self?.values: -> ::Array[ArkEmail::Models::WebhookTestParams::event]
       end

data/sig/ark_email/models/webhook_update_response.rbs

@@ -86,6 +86,8 @@ module ArkEmail
           | :MessageLinkClicked
           | :MessageLoaded
           | :DomainDNSError
+          | :SendLimitApproaching
+          | :SendLimitExceeded
 
         module Event
           extend ArkEmail::Internal::Type::Enum
@@ -98,6 +100,8 @@ module ArkEmail
           MESSAGE_LINK_CLICKED: :MessageLinkClicked
           MESSAGE_LOADED: :MessageLoaded
           DOMAIN_DNS_ERROR: :DomainDNSError
+          SEND_LIMIT_APPROACHING: :SendLimitApproaching
+          SEND_LIMIT_EXCEEDED: :SendLimitExceeded
 
           def self?.values: -> ::Array[ArkEmail::Models::WebhookUpdateResponse::Data::event]
         end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ark-email
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Ark
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-21 00:00:00.000000000 Z
+date: 2026-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi