ark-email 0.15.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ab2c267c0272df886fd6e21d8c157bf1534777bdf72da459141654a96e31866
-  data.tar.gz: 84150c3d0ec9b98e472fd7e76f584dd380122359adab410691ab95efb9beb887
+  metadata.gz: 80516ff1f11dea96e02d9e6e5a2c2a797c2fcf564896bc393cce624e065c437f
+  data.tar.gz: 252d553ed80a6ad7da61c5f2f0e4d20ab8e1614a468282ee1869d9ab54e884ff
 SHA512:
-  metadata.gz: 0400a57909216e295f59867461f74717a4815f8e2b3db006d5afe0625e6683c74281069c2db3e3888ce5c7acaccc9f6472a7c7f9952cc1fb3024eb1acf8bb226
-  data.tar.gz: 00aaabff41043bc684fcb450aff04f3367927068d6500fd8e3ff67d62b34bcfbd48cfa3f6b071ea1da24c0094d8198feadb06942e721eef441000769b0f209fb
+  metadata.gz: c28ced7a3366ca5aff00e4ebae824fec4cc1fe67f5f1d1d847042f22c19a14c7bd0578a5eb7b0915e4f3ad173343ecafe58b7a9563e9bbc24c4af91a206dc8c3
+  data.tar.gz: 2afcc0bb4524e08961c1073016d4bf8a2072c30e19ba2f7d50b9e43b2b752b9bce6c87274f47cb9a782f54ff5b5b05b9d5934ba5981d299e1e3e4dfbf8769b5a

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** api update ([24d1b7c](https://github.com/ArkHQ-io/ark-ruby/commit/24d1b7cfc75815134bd692975d49f69a365367f5))
+* **api:** api update ([0c5fd82](https://github.com/ArkHQ-io/ark-ruby/commit/0c5fd82bca7538e3cc09bceae1750294c8e26086))
+* **api:** manual updates ([b1d3c51](https://github.com/ArkHQ-io/ark-ruby/commit/b1d3c51060018d21e352e3b04df38e7e63607904))
+* **api:** manual updates ([5df18a4](https://github.com/ArkHQ-io/ark-ruby/commit/5df18a423121faf13af16e92f59ece007861539f))
+* **api:** manual updates ([51801ab](https://github.com/ArkHQ-io/ark-ruby/commit/51801ab3fb1e6752733194c8b0982e85eed46881))
+
 ## 0.15.0 (2026-01-29)
 
 Full Changelog: [v0.14.0...v0.15.0](https://github.com/ArkHQ-io/ark-ruby/compare/v0.14.0...v0.15.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.15.0"
+gem "ark-email", "~> 0.17.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/ark_email/models/email_list_response.rb

@@ -5,16 +5,11 @@ module ArkEmail
     # @see ArkEmail::Resources::Emails#list
     class EmailListResponse < ArkEmail::Internal::Type::BaseModel
       # @!attribute id
-      #   Internal message ID
+      #   Unique message identifier (token)
       #
       #   @return [String]
       required :id, String
 
-      # @!attribute token
-      #
-      #   @return [String]
-      required :token, String
-
       # @!attribute from
       #
       #   @return [String]
@@ -58,13 +53,11 @@ module ArkEmail
       #   @return [String, nil]
       optional :tag, String
 
-      # @!method initialize(id:, token:, from:, status:, subject:, timestamp:, timestamp_iso:, to:, tag: nil)
+      # @!method initialize(id:, from:, status:, subject:, timestamp:, timestamp_iso:, to:, tag: nil)
       #   Some parameter documentations has been truncated, see
       #   {ArkEmail::Models::EmailListResponse} for more details.
       #
-      #   @param id [String] Internal message ID
-      #
-      #   @param token [String]
+      #   @param id [String] Unique message identifier (token)
       #
       #   @param from [String]
       #

data/lib/ark_email/models/email_retrieve_deliveries_response.rb

@@ -26,8 +26,14 @@ module ArkEmail
 
       # @see ArkEmail::Models::EmailRetrieveDeliveriesResponse#data
       class Data < ArkEmail::Internal::Type::BaseModel
+        # @!attribute id
+        #   Message identifier (token)
+        #
+        #   @return [String]
+        required :id, String
+
         # @!attribute can_retry_manually
-        #   Whether the message can be manually retried via `POST /emails/{emailId}/retry`.
+        #   Whether the message can be manually retried via `POST /emails/{id}/retry`.
         #   `true` when the raw message content is still available (not expired). Messages
         #   older than the retention period cannot be retried.
         #
@@ -42,18 +48,6 @@ module ArkEmail
         required :deliveries,
                  -> { ArkEmail::Internal::Type::ArrayOf[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery] }
 
-        # @!attribute message_id
-        #   Internal numeric message ID
-        #
-        #   @return [Integer]
-        required :message_id, Integer, api_name: :messageId
-
-        # @!attribute message_token
-        #   Unique message token for API references
-        #
-        #   @return [String]
-        required :message_token, String, api_name: :messageToken
-
         # @!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.
@@ -77,17 +71,15 @@ module ArkEmail
         #   @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:)
+        # @!method initialize(id:, can_retry_manually:, deliveries:, 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 id [String] Message identifier (token)
         #
-        #   @param deliveries [Array<ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery>] Chronological list of delivery attempts for this message.
+        #   @param can_retry_manually [Boolean] Whether the message can be manually retried via `POST /emails/{id}/retry`.
         #
-        #   @param message_id [Integer] Internal numeric message ID
-        #
-        #   @param message_token [String] Unique message token for API references
+        #   @param deliveries [Array<ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery>] Chronological list of delivery attempts for this message.
         #
         #   @param retry_state [ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState, nil] Information about the current retry state of a message that is queued for delive
         #

data/lib/ark_email/models/email_retrieve_response.rb

@@ -27,19 +27,11 @@ module ArkEmail
       # @see ArkEmail::Models::EmailRetrieveResponse#data
       class Data < ArkEmail::Internal::Type::BaseModel
         # @!attribute id
-        #   Internal message ID
+        #   Unique message identifier (token)
         #
         #   @return [String]
         required :id, String
 
-        # @!attribute token
-        #   Unique message token used to retrieve this email via API. Combined with id to
-        #   form the full message identifier: msg*{id}*{token} Use this token with GET
-        #   /emails/{emailId} where emailId = "msg*{id}*{token}"
-        #
-        #   @return [String]
-        required :token, String
-
         # @!attribute from
         #   Sender address
         #
@@ -158,13 +150,11 @@ module ArkEmail
         #   @return [String, nil]
         optional :tag, String
 
-        # @!method initialize(id:, token:, from:, scope:, status:, subject:, timestamp:, timestamp_iso:, to:, activity: nil, attachments: nil, deliveries: nil, headers: nil, html_body: nil, message_id: nil, plain_body: nil, raw_message: nil, spam: nil, spam_score: nil, tag: nil)
+        # @!method initialize(id:, from:, scope:, status:, subject:, timestamp:, timestamp_iso:, to:, activity: nil, attachments: nil, deliveries: nil, headers: nil, html_body: nil, message_id: nil, plain_body: nil, raw_message: nil, spam: nil, spam_score: nil, tag: nil)
         #   Some parameter documentations has been truncated, see
         #   {ArkEmail::Models::EmailRetrieveResponse::Data} for more details.
         #
-        #   @param id [String] Internal message ID
-        #
-        #   @param token [String] Unique message token used to retrieve this email via API.
+        #   @param id [String] Unique message identifier (token)
         #
         #   @param from [String] Sender address
         #

data/lib/ark_email/models/email_retry_response.rb

@@ -26,12 +26,20 @@ module ArkEmail
 
       # @see ArkEmail::Models::EmailRetryResponse#data
       class Data < ArkEmail::Internal::Type::BaseModel
+        # @!attribute id
+        #   Email identifier (token)
+        #
+        #   @return [String]
+        required :id, String
+
         # @!attribute message
         #
         #   @return [String]
         required :message, String
 
-        # @!method initialize(message:)
+        # @!method initialize(id:, message:)
+        #   @param id [String] Email identifier (token)
+        #
         #   @param message [String]
       end
     end

data/lib/ark_email/models/email_send_batch_response.rb

@@ -74,20 +74,13 @@ module ArkEmail
 
         class Message < ArkEmail::Internal::Type::BaseModel
           # @!attribute id
-          #   Message ID
+          #   Message identifier (token)
           #
           #   @return [String]
           required :id, String
 
-          # @!attribute token
-          #
-          #   @return [String]
-          required :token, String
-
-          # @!method initialize(id:, token:)
-          #   @param id [String] Message ID
-          #
-          #   @param token [String]
+          # @!method initialize(id:)
+          #   @param id [String] Message identifier (token)
         end
       end
     end

data/lib/ark_email/models/email_send_raw_response.rb

@@ -27,7 +27,7 @@ module ArkEmail
       # @see ArkEmail::Models::EmailSendRawResponse#data
       class Data < ArkEmail::Internal::Type::BaseModel
         # @!attribute id
-        #   Unique message ID (format: msg*{id}*{token})
+        #   Unique message identifier (token)
         #
         #   @return [String]
         required :id, String
@@ -61,7 +61,7 @@ module ArkEmail
         #   Some parameter documentations has been truncated, see
         #   {ArkEmail::Models::EmailSendRawResponse::Data} for more details.
         #
-        #   @param id [String] Unique message ID (format: msg*{id}*{token})
+        #   @param id [String] Unique message identifier (token)
         #
         #   @param status [Symbol, ArkEmail::Models::EmailSendRawResponse::Data::Status] Current delivery status
         #

data/lib/ark_email/models/email_send_response.rb

@@ -27,7 +27,7 @@ module ArkEmail
       # @see ArkEmail::Models::EmailSendResponse#data
       class Data < ArkEmail::Internal::Type::BaseModel
         # @!attribute id
-        #   Unique message ID (format: msg*{id}*{token})
+        #   Unique message identifier (token)
         #
         #   @return [String]
         required :id, String
@@ -61,7 +61,7 @@ module ArkEmail
         #   Some parameter documentations has been truncated, see
         #   {ArkEmail::Models::EmailSendResponse::Data} for more details.
         #
-        #   @param id [String] Unique message ID (format: msg*{id}*{token})
+        #   @param id [String] Unique message identifier (token)
         #
         #   @param status [Symbol, ArkEmail::Models::EmailSendResponse::Data::Status] Current delivery status
         #

data/lib/ark_email/models/log_entry.rb

@@ -231,7 +231,7 @@ module ArkEmail
       # @see ArkEmail::Models::LogEntry#email
       class Email < ArkEmail::Internal::Type::BaseModel
         # @!attribute id
-        #   Email message ID
+        #   Email message identifier (token)
         #
         #   @return [String, nil]
         optional :id, String
@@ -245,7 +245,7 @@ module ArkEmail
         # @!method initialize(id: nil, recipient_count: nil)
         #   Email-specific data (for email endpoints)
         #
-        #   @param id [String] Email message ID
+        #   @param id [String] Email message identifier (token)
         #
         #   @param recipient_count [Integer, nil] Number of recipients
       end

data/lib/ark_email/resources/emails.rb

@@ -12,9 +12,9 @@ module ArkEmail
       # Use the `expand` parameter to include additional data like the HTML/text body,
       # headers, or delivery attempts.
       #
-      # @overload retrieve(email_id, expand: nil, request_options: {})
+      # @overload retrieve(id, expand: nil, request_options: {})
       #
-      # @param email_id [String] The email ID (from send response) or message token
+      # @param id [String] The email identifier (token returned from send response)
       #
       # @param expand [String] Comma-separated list of fields to include:
       #
@@ -23,11 +23,11 @@ module ArkEmail
       # @return [ArkEmail::Models::EmailRetrieveResponse]
       #
       # @see ArkEmail::Models::EmailRetrieveParams
-      def retrieve(email_id, params = {})
+      def retrieve(id, params = {})
         parsed, options = ArkEmail::EmailRetrieveParams.dump_request(params)
         @client.request(
           method: :get,
-          path: ["emails/%1$s", email_id],
+          path: ["emails/%1$s", id],
           query: parsed,
           model: ArkEmail::Models::EmailRetrieveResponse,
           options: options
@@ -118,23 +118,23 @@ module ArkEmail
       #
       # ### 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
+      # Indicates whether you can call `POST /emails/{id}/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: {})
+      # @overload retrieve_deliveries(id, request_options: {})
       #
-      # @param email_id [String] Email identifier. Accepts multiple formats:
+      # @param id [String] Email identifier (the token returned when sending an email).
       #
       # @param request_options [ArkEmail::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ArkEmail::Models::EmailRetrieveDeliveriesResponse]
       #
       # @see ArkEmail::Models::EmailRetrieveDeliveriesParams
-      def retrieve_deliveries(email_id, params = {})
+      def retrieve_deliveries(id, params = {})
         @client.request(
           method: :get,
-          path: ["emails/%1$s/deliveries", email_id],
+          path: ["emails/%1$s/deliveries", id],
           model: ArkEmail::Models::EmailRetrieveDeliveriesResponse,
           options: params[:request_options]
         )
@@ -145,18 +145,19 @@ module ArkEmail
       #
       # Only works for emails that have failed or are in a retryable state.
       #
-      # @overload retry_(email_id, request_options: {})
+      # @overload retry_(id, request_options: {})
+      #
+      # @param id [String] The email identifier (token returned from send response)
       #
-      # @param email_id [String]
       # @param request_options [ArkEmail::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ArkEmail::Models::EmailRetryResponse]
       #
       # @see ArkEmail::Models::EmailRetryParams
-      def retry_(email_id, params = {})
+      def retry_(id, params = {})
         @client.request(
           method: :post,
-          path: ["emails/%1$s/retry", email_id],
+          path: ["emails/%1$s/retry", id],
           model: ArkEmail::Models::EmailRetryResponse,
           options: params[:request_options]
         )

data/lib/ark_email/version.rb

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

data/rbi/ark_email/models/email_list_response.rbi

@@ -11,13 +11,10 @@ module ArkEmail
           )
         end
 
-      # Internal message ID
+      # Unique message identifier (token)
       sig { returns(String) }
       attr_accessor :id
 
-      sig { returns(String) }
-      attr_accessor :token
-
       sig { returns(String) }
       attr_accessor :from
 
@@ -53,7 +50,6 @@ module ArkEmail
       sig do
         params(
           id: String,
-          token: String,
           from: String,
           status: ArkEmail::Models::EmailListResponse::Status::OrSymbol,
           subject: String,
@@ -64,9 +60,8 @@ module ArkEmail
         ).returns(T.attached_class)
       end
       def self.new(
-        # Internal message ID
+        # Unique message identifier (token)
         id:,
-        token:,
         from:,
         # Current delivery status:
         #
@@ -89,7 +84,6 @@ module ArkEmail
         override.returns(
           {
             id: String,
-            token: String,
             from: String,
             status: ArkEmail::Models::EmailListResponse::Status::TaggedSymbol,
             subject: String,

data/rbi/ark_email/models/email_retrieve_deliveries_response.rbi

@@ -61,7 +61,11 @@ module ArkEmail
             )
           end
 
-        # Whether the message can be manually retried via `POST /emails/{emailId}/retry`.
+        # Message identifier (token)
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Whether the message can be manually retried via `POST /emails/{id}/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) }
@@ -78,14 +82,6 @@ module ArkEmail
         end
         attr_accessor :deliveries
 
-        # Internal numeric message ID
-        sig { returns(Integer) }
-        attr_accessor :message_id
-
-        # 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
@@ -124,13 +120,12 @@ module ArkEmail
 
         sig do
           params(
+            id: String,
             can_retry_manually: T::Boolean,
             deliveries:
               T::Array[
                 ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery::OrHash
               ],
-            message_id: Integer,
-            message_token: String,
             retry_state:
               T.nilable(
                 ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState::OrHash
@@ -140,17 +135,15 @@ module ArkEmail
           ).returns(T.attached_class)
         end
         def self.new(
-          # Whether the message can be manually retried via `POST /emails/{emailId}/retry`.
+          # Message identifier (token)
+          id:,
+          # Whether the message can be manually retried via `POST /emails/{id}/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 numeric message ID
-          message_id:,
-          # 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:,
@@ -169,13 +162,12 @@ module ArkEmail
         sig do
           override.returns(
             {
+              id: String,
               can_retry_manually: T::Boolean,
               deliveries:
                 T::Array[
                   ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery
                 ],
-              message_id: Integer,
-              message_token: String,
               retry_state:
                 T.nilable(
                   ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState

data/rbi/ark_email/models/email_retrieve_response.rbi

@@ -59,16 +59,10 @@ module ArkEmail
             )
           end
 
-        # Internal message ID
+        # Unique message identifier (token)
         sig { returns(String) }
         attr_accessor :id
 
-        # Unique message token used to retrieve this email via API. Combined with id to
-        # form the full message identifier: msg*{id}*{token} Use this token with GET
-        # /emails/{emailId} where emailId = "msg*{id}*{token}"
-        sig { returns(String) }
-        attr_accessor :token
-
         # Sender address
         sig { returns(String) }
         attr_accessor :from
@@ -230,7 +224,6 @@ module ArkEmail
         sig do
           params(
             id: String,
-            token: String,
             from: String,
             scope:
               ArkEmail::Models::EmailRetrieveResponse::Data::Scope::OrSymbol,
@@ -261,12 +254,8 @@ module ArkEmail
           ).returns(T.attached_class)
         end
         def self.new(
-          # Internal message ID
+          # Unique message identifier (token)
           id:,
-          # Unique message token used to retrieve this email via API. Combined with id to
-          # form the full message identifier: msg*{id}*{token} Use this token with GET
-          # /emails/{emailId} where emailId = "msg*{id}*{token}"
-          token:,
           # Sender address
           from:,
           # Message direction
@@ -318,7 +307,6 @@ module ArkEmail
           override.returns(
             {
               id: String,
-              token: String,
               from: String,
               scope:
                 ArkEmail::Models::EmailRetrieveResponse::Data::Scope::TaggedSymbol,

data/rbi/ark_email/models/email_retry_response.rbi

@@ -59,14 +59,22 @@ module ArkEmail
             )
           end
 
+        # Email identifier (token)
+        sig { returns(String) }
+        attr_accessor :id
+
         sig { returns(String) }
         attr_accessor :message
 
-        sig { params(message: String).returns(T.attached_class) }
-        def self.new(message:)
+        sig { params(id: String, message: String).returns(T.attached_class) }
+        def self.new(
+          # Email identifier (token)
+          id:,
+          message:
+        )
         end
 
-        sig { override.returns({ message: String }) }
+        sig { override.returns({ id: String, message: String }) }
         def to_hash
         end
       end

data/rbi/ark_email/models/email_send_batch_response.rbi

@@ -147,22 +147,18 @@ module ArkEmail
               )
             end
 
-          # Message ID
+          # Message identifier (token)
           sig { returns(String) }
           attr_accessor :id
 
-          sig { returns(String) }
-          attr_accessor :token
-
-          sig { params(id: String, token: String).returns(T.attached_class) }
+          sig { params(id: String).returns(T.attached_class) }
           def self.new(
-            # Message ID
-            id:,
-            token:
+            # Message identifier (token)
+            id:
           )
           end
 
-          sig { override.returns({ id: String, token: String }) }
+          sig { override.returns({ id: String }) }
           def to_hash
           end
         end

data/rbi/ark_email/models/email_send_raw_response.rbi

@@ -59,7 +59,7 @@ module ArkEmail
             )
           end
 
-        # Unique message ID (format: msg*{id}*{token})
+        # Unique message identifier (token)
         sig { returns(String) }
         attr_accessor :id
 
@@ -101,7 +101,7 @@ module ArkEmail
           ).returns(T.attached_class)
         end
         def self.new(
-          # Unique message ID (format: msg*{id}*{token})
+          # Unique message identifier (token)
           id:,
           # Current delivery status
           status:,

data/rbi/ark_email/models/email_send_response.rbi

@@ -59,7 +59,7 @@ module ArkEmail
             )
           end
 
-        # Unique message ID (format: msg*{id}*{token})
+        # Unique message identifier (token)
         sig { returns(String) }
         attr_accessor :id
 
@@ -100,7 +100,7 @@ module ArkEmail
           ).returns(T.attached_class)
         end
         def self.new(
-          # Unique message ID (format: msg*{id}*{token})
+          # Unique message identifier (token)
           id:,
           # Current delivery status
           status:,

data/rbi/ark_email/models/log_entry.rbi

@@ -323,7 +323,7 @@ module ArkEmail
             T.any(ArkEmail::LogEntry::Email, ArkEmail::Internal::AnyHash)
           end
 
-        # Email message ID
+        # Email message identifier (token)
         sig { returns(T.nilable(String)) }
         attr_reader :id
 
@@ -341,7 +341,7 @@ module ArkEmail
           )
         end
         def self.new(
-          # Email message ID
+          # Email message identifier (token)
           id: nil,
           # Number of recipients
           recipient_count: nil

data/rbi/ark_email/resources/emails.rbi

@@ -10,14 +10,14 @@ module ArkEmail
       # headers, or delivery attempts.
       sig do
         params(
-          email_id: String,
+          id: String,
           expand: String,
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::EmailRetrieveResponse)
       end
       def retrieve(
-        # The email ID (from send response) or message token
-        email_id,
+        # The email identifier (token returned from send response)
+        id,
         # Comma-separated list of fields to include:
         #
         # - `full` - Include all expanded fields in a single request
@@ -119,22 +119,18 @@ module ArkEmail
       #
       # ### 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
+      # Indicates whether you can call `POST /emails/{id}/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,
+          id: String,
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::EmailRetrieveDeliveriesResponse)
       end
       def retrieve_deliveries(
-        # Email identifier. Accepts multiple formats:
-        #
-        # - Message ID (numeric): `12345`
-        # - Message token: `aBc123XyZ`
-        # - Combined format: `msg_12345_aBc123XyZ`
-        email_id,
+        # Email identifier (the token returned when sending an email).
+        id,
         request_options: {}
       )
       end
@@ -145,11 +141,15 @@ module ArkEmail
       # Only works for emails that have failed or are in a retryable state.
       sig do
         params(
-          email_id: String,
+          id: String,
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::EmailRetryResponse)
       end
-      def retry_(email_id, request_options: {})
+      def retry_(
+        # The email identifier (token returned from send response)
+        id,
+        request_options: {}
+      )
       end
 
       # Send a single email message. The email is accepted for immediate delivery and

data/sig/ark_email/models/email_list_response.rbs

@@ -3,7 +3,6 @@ module ArkEmail
     type email_list_response =
       {
         id: String,
-        token: String,
         from: String,
         status: ArkEmail::Models::EmailListResponse::status,
         subject: String,
@@ -16,8 +15,6 @@ module ArkEmail
     class EmailListResponse < ArkEmail::Internal::Type::BaseModel
       attr_accessor id: String
 
-      attr_accessor token: String
-
       attr_accessor from: String
 
       attr_accessor status: ArkEmail::Models::EmailListResponse::status
@@ -36,7 +33,6 @@ module ArkEmail
 
       def initialize: (
         id: String,
-        token: String,
         from: String,
         status: ArkEmail::Models::EmailListResponse::status,
         subject: String,
@@ -48,7 +44,6 @@ module ArkEmail
 
       def to_hash: -> {
         id: String,
-        token: String,
         from: String,
         status: ArkEmail::Models::EmailListResponse::status,
         subject: String,

data/sig/ark_email/models/email_retrieve_deliveries_response.rbs

@@ -28,41 +28,36 @@ module ArkEmail
 
       type data =
         {
+          id: String,
           can_retry_manually: bool,
           deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery],
-          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 id: String
+
         attr_accessor can_retry_manually: bool
 
         attr_accessor deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery]
 
-        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: (
+          id: String,
           can_retry_manually: bool,
           deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery],
-          message_id: Integer,
-          message_token: String,
           retry_state: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState?,
           status: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::status
         ) -> void
 
         def to_hash: -> {
+          id: String,
           can_retry_manually: bool,
           deliveries: ::Array[ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::Delivery],
-          message_id: Integer,
-          message_token: String,
           retry_state: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::RetryState?,
           status: ArkEmail::Models::EmailRetrieveDeliveriesResponse::Data::status
         }

data/sig/ark_email/models/email_retrieve_response.rbs

@@ -29,7 +29,6 @@ module ArkEmail
       type data =
         {
           id: String,
-          token: String,
           from: String,
           scope: ArkEmail::Models::EmailRetrieveResponse::Data::scope,
           status: ArkEmail::Models::EmailRetrieveResponse::Data::status,
@@ -53,8 +52,6 @@ module ArkEmail
       class Data < ArkEmail::Internal::Type::BaseModel
         attr_accessor id: String
 
-        attr_accessor token: String
-
         attr_accessor from: String
 
         attr_accessor scope: ArkEmail::Models::EmailRetrieveResponse::Data::scope
@@ -121,7 +118,6 @@ module ArkEmail
 
         def initialize: (
           id: String,
-          token: String,
           from: String,
           scope: ArkEmail::Models::EmailRetrieveResponse::Data::scope,
           status: ArkEmail::Models::EmailRetrieveResponse::Data::status,
@@ -144,7 +140,6 @@ module ArkEmail
 
         def to_hash: -> {
           id: String,
-          token: String,
           from: String,
           scope: ArkEmail::Models::EmailRetrieveResponse::Data::scope,
           status: ArkEmail::Models::EmailRetrieveResponse::Data::status,

data/sig/ark_email/models/email_retry_response.rbs

@@ -26,14 +26,16 @@ module ArkEmail
         success: true
       }
 
-      type data = { message: String }
+      type data = { id: String, message: String }
 
       class Data < ArkEmail::Internal::Type::BaseModel
+        attr_accessor id: String
+
         attr_accessor message: String
 
-        def initialize: (message: String) -> void
+        def initialize: (id: String, message: String) -> void
 
-        def to_hash: -> { message: String }
+        def to_hash: -> { id: String, message: String }
       end
     end
   end

data/sig/ark_email/models/email_send_batch_response.rbs

@@ -64,16 +64,14 @@ module ArkEmail
           sandbox: bool
         }
 
-        type message = { id: String, token: String }
+        type message = { id: String }
 
         class Message < ArkEmail::Internal::Type::BaseModel
           attr_accessor id: String
 
-          attr_accessor token: String
+          def initialize: (id: String) -> void
 
-          def initialize: (id: String, token: String) -> void
-
-          def to_hash: -> { id: String, token: String }
+          def to_hash: -> { id: String }
         end
       end
     end

data/sig/ark_email/resources/emails.rbs

@@ -2,7 +2,7 @@ module ArkEmail
   module Resources
     class Emails
       def retrieve: (
-        String email_id,
+        String id,
         ?expand: String,
         ?request_options: ArkEmail::request_opts
       ) -> ArkEmail::Models::EmailRetrieveResponse
@@ -20,12 +20,12 @@ module ArkEmail
       ) -> ArkEmail::Internal::PageNumberPagination[ArkEmail::Models::EmailListResponse]
 
       def retrieve_deliveries: (
-        String email_id,
+        String id,
         ?request_options: ArkEmail::request_opts
       ) -> ArkEmail::Models::EmailRetrieveDeliveriesResponse
 
       def retry_: (
-        String email_id,
+        String id,
         ?request_options: ArkEmail::request_opts
       ) -> ArkEmail::Models::EmailRetryResponse
 

metadata

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