mailinator_client 1.0.6 → 1.1.0

data/lib/mailinator_client/messages.rb

@@ -1,26 +1,6 @@
-# The MIT License (MIT)
-#
-# Copyright (c) 2024 Manybrain, Inc.
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
 require "json"
+require "net/http"
+require "uri"
 
 module MailinatorClient
 
@@ -38,7 +18,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {number} skip - [Optional] Skip this many emails in your Private Domain
     # *  {number} limit - [Optional] Number of emails to fetch from your Private Domain
@@ -47,7 +27,6 @@ module MailinatorClient
     # *  {string} cursor - [Optional] Pagination cursor for large result sets (obtained from previous response)
     # *  {boolean} full - [Optional] Return full email content with body/attachments (true) or just metadata (false). Default: false
     # *  {string} delete - [Optional] Auto-delete message after retrieval (e.g., "10s" = 10 seconds, "5m" = 5 minutes)
-    # *  {string} wait - [Optional] Maximum time to wait for new messages (e.g., "30s" = 30 seconds)
     #
     # Responses:
     # *  Collection of messages (https://manybrain.github.io/m8rdocs/#fetch-inbox-aka-fetch-message-summaries)
@@ -67,16 +46,17 @@ module MailinatorClient
       query_params[:cursor] = params[:cursor] if params.has_key?(:cursor)
       query_params[:full] = params[:full] if params.has_key?(:full)
       query_params[:delete] = params[:delete] if params.has_key?(:delete)
-      query_params[:wait] = params[:wait] if params.has_key?(:wait)
 
       path = "/domains/#{params[:domain]}/inboxes/#{params[:inbox]}"
 
-      @client.request(
+      response = @client.request(
         method: :get,
         path: path,
         query: query_params,
         headers: headers,
         body: body)
+
+      response
     end
 
     # Retrieves a specific message by id for specific inbox.
@@ -86,9 +66,10 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageId - The Message id
+    # *  {string} delete - [Optional] Auto-delete message after retrieval (e.g., "10s" = 10 seconds, "5m" = 5 minutes)
     #
     # Responses:
     # *  Message (https://manybrain.github.io/m8rdocs/#fetch-inbox-message)
@@ -102,6 +83,8 @@ module MailinatorClient
       raise ArgumentError.new("inbox is required") unless params.has_key?(:inbox)
       raise ArgumentError.new("message id is required") unless params.has_key?(:messageId)
 
+      query_params[:delete] = params[:delete] if params.has_key?(:delete)
+
       path = "/domains/#{params[:domain]}/inboxes/#{params[:inbox]}/messages/#{params[:messageId]}"
 
       @client.request(
@@ -119,12 +102,12 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} messageId - The Message id
     # *  {string} delete - [Optional] Auto-delete message after retrieval (e.g., "10s" = 10 seconds, "5m" = 5 minutes)
     #
     # Responses:
-    # *  Message (https://manybrain.github.io/m8rdocs/#fetch-message)
+    # *  Message (https://www.mailinator.com/documentation/docs/api/get-domain-message/index.html)
     def fetch_message(params = {})
       params = Utils.symbolize_hash_keys(params)
       query_params = { }
@@ -146,6 +129,421 @@ module MailinatorClient
         body: body)
     end
 
+    # Retrieves the summary for a specific message by id.
+    #
+    # Authentication:
+    # The client must be configured with a valid api
+    # access token to call this action.
+    #
+    # Parameters:
+    # *  {string} domainId - The Domain name or simply 'private'
+    # *  {string} messageId - The Message id
+    #
+    # Responses:
+    # *  Message summary
+    def fetch_message_summary(params = {})
+      params = Utils.symbolize_hash_keys(params)
+      query_params = { }
+      headers = {}
+      body = nil
+
+      raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
+      raise ArgumentError.new("message id is required") unless params.has_key?(:messageId)
+
+      path = "/domains/#{params[:domain]}/messages/#{params[:messageId]}/summary"
+
+      @client.request(
+        method: :get,
+        path: path,
+        query: query_params,
+        headers: headers,
+        body: body)
+    end
+
+    # Retrieves text content for a specific message by id.
+    #
+    # Authentication:
+    # The client must be configured with a valid api
+    # access token to call this action.
+    #
+    # Parameters:
+    # *  {string} domainId - The Domain name or simply 'private'
+    # *  {string} messageId - The Message id
+    #
+    # Responses:
+    # *  Message text response
+    def fetch_message_text(params = {})
+      params = Utils.symbolize_hash_keys(params)
+      query_params = { }
+      headers = {}
+      body = nil
+
+      raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
+      raise ArgumentError.new("message id is required") unless params.has_key?(:messageId)
+
+      path = "/domains/#{params[:domain]}/messages/#{params[:messageId]}/text"
+
+      @client.request(
+        method: :get,
+        path: path,
+        query: query_params,
+        headers: headers,
+        body: body)
+    end
+
+    # Retrieves text/plain content for a specific message by id.
+    #
+    # Authentication:
+    # The client must be configured with a valid api
+    # access token to call this action.
+    #
+    # Parameters:
+    # *  {string} domainId - The Domain name or simply 'private'
+    # *  {string} messageId - The Message id
+    #
+    # Responses:
+    # *  Message text/plain response
+    def fetch_message_textplain(params = {})
+      params = Utils.symbolize_hash_keys(params)
+      query_params = { }
+      headers = {}
+      body = nil
+
+      raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
+      raise ArgumentError.new("message id is required") unless params.has_key?(:messageId)
+
+      path = "/domains/#{params[:domain]}/messages/#{params[:messageId]}/textplain"
+
+      @client.request(
+        method: :get,
+        path: path,
+        query: query_params,
+        headers: headers,
+        body: body)
+    end
+
+    # Retrieves text/html content for a specific message by id.
+    #
+    # Authentication:
+    # The client must be configured with a valid api
+    # access token to call this action.
+    #
+    # Parameters:
+    # *  {string} domainId - The Domain name or simply 'private'
+    # *  {string} messageId - The Message id
+    #
+    # Responses:
+    # *  Message text/html response
+    def fetch_message_texthtml(params = {})
+      params = Utils.symbolize_hash_keys(params)
+      query_params = { }
+      headers = {}
+      body = nil
+
+      raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
+      raise ArgumentError.new("message id is required") unless params.has_key?(:messageId)
+
+      path = "/domains/#{params[:domain]}/messages/#{params[:messageId]}/texthtml"
+
+      @client.request(
+        method: :get,
+        path: path,
+        query: query_params,
+        headers: headers,
+        body: body)
+    end
+
+    # Retrieves headers for a specific message by id.
+    #
+    # Authentication:
+    # The client must be configured with a valid api
+    # access token to call this action.
+    #
+    # Parameters:
+    # *  {string} domainId - The Domain name or simply 'private'
+    # *  {string} messageId - The Message id
+    #
+    # Responses:
+    # *  Message headers response
+    def fetch_message_headers(params = {})
+      params = Utils.symbolize_hash_keys(params)
+      query_params = { }
+      headers = {}
+      body = nil
+
+      raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
+      raise ArgumentError.new("message id is required") unless params.has_key?(:messageId)
+
+      path = "/domains/#{params[:domain]}/messages/#{params[:messageId]}/headers"
+
+      @client.request(
+        method: :get,
+        path: path,
+        query: query_params,
+        headers: headers,
+        body: body)
+    end
+
+    # Streams all messages from a domain.
+    #
+    # Authentication:
+    # The client must be configured with a valid api
+    # access token to call this action.
+    #
+    # Parameters:
+    # *  {string} domainId - The Domain name or simply 'private'
+    # *  {boolean} full - [Optional] Return full email content with body/attachments (true) or just metadata (false). Default: false
+    # *  {number} limit - [Optional] Number of messages to fetch
+    # *  {number} throttleInterval - [Optional] Throttle interval in milliseconds
+    # *  {string} delete - [Optional] Auto-delete message after retrieval (e.g., "10s" = 10 seconds, "5m" = 5 minutes)
+    #
+    # Responses:
+    # *  Message stream response
+    def stream_domain_messages(params = {})
+      params = Utils.symbolize_hash_keys(params)
+      query_params = { }
+      headers = {}
+      body = nil
+
+      raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
+
+      query_params[:full] = params[:full] if params.has_key?(:full)
+      query_params[:limit] = params[:limit] if params.has_key?(:limit)
+      query_params[:throttleInterval] = params[:throttleInterval] if params.has_key?(:throttleInterval)
+      query_params[:delete] = params[:delete] if params.has_key?(:delete)
+
+      path = "/domains/#{params[:domain]}/stream"
+
+      uri = URI.parse(@client.url + path)
+      query = Utils.fix_query_arrays(query_params)
+      uri.query = URI.encode_www_form(query) unless query.nil? || query.empty?
+
+      headers["Accept"] = "application/json"
+      headers["Content-Type"] = "application/json"
+      headers["User-Agent"] = "Mailinator SDK - Ruby V#{MailinatorClient::VERSION}"
+      headers["Authorization"] = @client.auth_token if @client.auth_token
+
+      response_body = +""
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.read_timeout = 20
+
+      request = Net::HTTP::Get.new(uri)
+      headers.each { |key, value| request[key] = value }
+
+      http.request(request) do |response|
+        if response.code.to_i >= 400
+          raise ResponseError.new(response.code.to_i, nil, response.body)
+        end
+
+        catch(:done) do
+          response.read_body do |chunk|
+            response_body << chunk
+            if response_body.include?("\n\n") || response_body.include?("}\n") || response_body.strip.end_with?("}")
+              throw :done
+            end
+          end
+        end
+      end
+
+      payload = response_body.strip
+      if payload.start_with?("data:")
+        payload_line = payload.lines.find { |line| line.start_with?("data:") }
+        payload = payload_line.to_s.sub(/^data:\\s*/, "").strip
+      end
+
+      parsed = begin
+        JSON.parse(payload)
+      rescue JSON::ParserError
+        cleaned = payload.encode("UTF-8", invalid: :replace, undef: :replace, replace: "")
+        candidate = cleaned
+        if candidate.include?("data:")
+          data_line = candidate.lines.find { |line| line.start_with?("data:") }
+          candidate = data_line.to_s.sub(/^data:\s*/, "")
+        end
+
+        in_string = false
+        escape = false
+        depth = 0
+        start_idx = nil
+        end_idx = nil
+
+        candidate.each_char.with_index do |ch, idx|
+          if start_idx.nil?
+            if ch == "{"
+              start_idx = idx
+              depth = 1
+            end
+            next
+          end
+
+          if in_string
+            if escape
+              escape = false
+            elsif ch == "\\"
+              escape = true
+            elsif ch == "\""
+              in_string = false
+            end
+          else
+            case ch
+            when "\""
+              in_string = true
+            when "{"
+              depth += 1
+            when "}"
+              depth -= 1
+              if depth == 0
+                end_idx = idx
+                break
+              end
+            end
+          end
+        end
+
+        if start_idx && end_idx && end_idx >= start_idx
+          JSON.parse(candidate[start_idx..end_idx])
+        end
+      end
+
+      raise ResponseError.new(500, nil, payload) if parsed.nil?
+
+      return parsed if parsed.is_a?(Hash) && parsed.key?("domain") && parsed.key?("msgs")
+      return { "domain" => parsed["domain"], "to" => parsed["to"], "msgs" => [parsed] } if parsed.is_a?(Hash)
+      parsed
+    end
+
+    # Streams all messages from an inbox.
+    #
+    # Authentication:
+    # The client must be configured with a valid api
+    # access token to call this action.
+    #
+    # Parameters:
+    # *  {string} domainId - The Domain name or simply 'private'
+    # *  {string} inbox - The Inbox name
+    # *  {boolean} full - [Optional] Return full email content with body/attachments (true) or just metadata (false). Default: false
+    # *  {number} limit - [Optional] Number of messages to fetch
+    # *  {number} throttleInterval - [Optional] Throttle interval in milliseconds
+    # *  {string} delete - [Optional] Auto-delete message after retrieval (e.g., "10s" = 10 seconds, "5m" = 5 minutes)
+    #
+    # Responses:
+    # *  Message stream response
+    def stream_inbox_messages(params = {})
+      params = Utils.symbolize_hash_keys(params)
+      query_params = { }
+      headers = {}
+      body = nil
+
+      raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
+      raise ArgumentError.new("inbox is required") unless params.has_key?(:inbox)
+
+      query_params[:full] = params[:full] if params.has_key?(:full)
+      query_params[:limit] = params[:limit] if params.has_key?(:limit)
+      query_params[:throttleInterval] = params[:throttleInterval] if params.has_key?(:throttleInterval)
+      query_params[:delete] = params[:delete] if params.has_key?(:delete)
+
+      path = "/domains/#{params[:domain]}/stream/#{params[:inbox]}"
+
+      uri = URI.parse(@client.url + path)
+      query = Utils.fix_query_arrays(query_params)
+      uri.query = URI.encode_www_form(query) unless query.nil? || query.empty?
+
+      headers["Accept"] = "application/json"
+      headers["Content-Type"] = "application/json"
+      headers["User-Agent"] = "Mailinator SDK - Ruby V#{MailinatorClient::VERSION}"
+      headers["Authorization"] = @client.auth_token if @client.auth_token
+
+      response_body = +""
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.read_timeout = 20
+
+      request = Net::HTTP::Get.new(uri)
+      headers.each { |key, value| request[key] = value }
+
+      http.request(request) do |response|
+        if response.code.to_i >= 400
+          raise ResponseError.new(response.code.to_i, nil, response.body)
+        end
+
+        catch(:done) do
+          response.read_body do |chunk|
+            response_body << chunk
+            if response_body.include?("\n\n") || response_body.include?("}\n") || response_body.strip.end_with?("}")
+              throw :done
+            end
+          end
+        end
+      end
+
+      payload = response_body.strip
+      if payload.start_with?("data:")
+        payload_line = payload.lines.find { |line| line.start_with?("data:") }
+        payload = payload_line.to_s.sub(/^data:\\s*/, "").strip
+      end
+
+      parsed = begin
+        JSON.parse(payload)
+      rescue JSON::ParserError
+        cleaned = payload.encode("UTF-8", invalid: :replace, undef: :replace, replace: "")
+        candidate = cleaned
+        if candidate.include?("data:")
+          data_line = candidate.lines.find { |line| line.start_with?("data:") }
+          candidate = data_line.to_s.sub(/^data:\s*/, "")
+        end
+
+        in_string = false
+        escape = false
+        depth = 0
+        start_idx = nil
+        end_idx = nil
+
+        candidate.each_char.with_index do |ch, idx|
+          if start_idx.nil?
+            if ch == "{"
+              start_idx = idx
+              depth = 1
+            end
+            next
+          end
+
+          if in_string
+            if escape
+              escape = false
+            elsif ch == "\\"
+              escape = true
+            elsif ch == "\""
+              in_string = false
+            end
+          else
+            case ch
+            when "\""
+              in_string = true
+            when "{"
+              depth += 1
+            when "}"
+              depth -= 1
+              if depth == 0
+                end_idx = idx
+                break
+              end
+            end
+          end
+        end
+
+        if start_idx && end_idx && end_idx >= start_idx
+          JSON.parse(candidate[start_idx..end_idx])
+        end
+      end
+
+      raise ResponseError.new(500, nil, payload) if parsed.nil?
+
+      return parsed if parsed.is_a?(Hash) && parsed.key?("domain") && parsed.key?("msgs")
+      return { "domain" => parsed["domain"], "to" => parsed["to"], "msgs" => [parsed] } if parsed.is_a?(Hash)
+      parsed
+    end
+
     # Retrieves a specific SMS message by sms number.
     #
     # Authentication:
@@ -153,20 +551,38 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} teamSmsNumber - The Team sms number
+    # *  {number} skip - [Optional] Skip this many emails in your Private Domain
+    # *  {number} limit - [Optional] Number of emails to fetch from your Private Domain
+    # *  {string} sort - [Optional] Sort results by ascending or descending
+    # *  {boolean} decode_subject - [Optional] true: decode encoded subjects
+    # *  {string} cursor - [Optional] Pagination cursor for large result sets (obtained from previous response)
+    # *  {boolean} full - [Optional] Return full email content with body/attachments (true) or just metadata (false). Default: false
+    # *  {string} delete - [Optional] Auto-delete message after retrieval (e.g., "10s" = 10 seconds, "5m" = 5 minutes)
+    # *  {string} wait - [Optional] Maximum time to wait for new messages (e.g., "30s" = 30 seconds)
     #
     # Responses:
     # *  Collection of messages (https://manybrain.github.io/m8rdocs/#fetch-an-sms-messages)
     def fetch_sms_message(params = {})
       params = Utils.symbolize_hash_keys(params)
-      query_params = { }
+      query_params = { skip: 0, limit: 50, sort: "ascending", decode_subject: false }
       headers = {}
       body = nil
 
       raise ArgumentError.new("domain is required") unless params.has_key?(:domain)
       raise ArgumentError.new("team sms number is required") unless params.has_key?(:teamSmsNumber)
 
+      query_params[:skip] = params[:skip] if params.has_key?(:skip)
+      query_params[:limit] = params[:limit] if params.has_key?(:limit)
+      query_params[:sort] = params[:sort] if params.has_key?(:sort)
+      query_params[:decode_subject] = params[:decode_subject] if params.has_key?(:decode_subject)
+      query_params[:decode_subject] = params[:decodeSubject] if params.has_key?(:decodeSubject)
+      query_params[:cursor] = params[:cursor] if params.has_key?(:cursor)
+      query_params[:full] = params[:full] if params.has_key?(:full)
+      query_params[:delete] = params[:delete] if params.has_key?(:delete)
+      query_params[:wait] = params[:wait] if params.has_key?(:wait)
+
       path = "/domains/#{params[:domain]}/inboxes/#{params[:teamSmsNumber]}"
 
       @client.request(
@@ -184,7 +600,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageId - The Message id
     #
@@ -217,7 +633,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} messageId - The Message id
     #
     # Responses:
@@ -248,7 +664,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageId - The Message id
     # *  {string} attachmentId - The Attachment id
@@ -283,7 +699,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} messageId - The Message id
     # *  {string} attachmentId - The Attachment id
     #
@@ -316,7 +732,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} messageId - The Message id
     #
     # Responses:
@@ -347,7 +763,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} messageId - The Message id
     #
     # Responses:
@@ -378,7 +794,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageId - The Message id
     #
@@ -411,7 +827,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     #
     # Responses:
     # *  Status and count of removed messages (https://manybrain.github.io/m8rdocs/#delete-all-messages-by-domain)
@@ -440,7 +856,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     #
     # Responses:
@@ -471,7 +887,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageId - The Message id
     #
@@ -504,7 +920,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageToPost - The Message object (https://manybrain.github.io/m8rdocs/#inject-a-message-http-post-messages)
     #
@@ -539,7 +955,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} messageId - The Message id
     #
     # Responses:
@@ -570,7 +986,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageId - The Message id
     #
@@ -603,7 +1019,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} messageId - The Message id
     #
     # Responses:
@@ -634,7 +1050,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     # *  {string} messageId - The Message id
     #
@@ -667,7 +1083,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     #
     # Responses:
     # *  Collection of latest messages (https://manybrain.github.io/m8rdocs/#fetch-latest-messages)
@@ -696,7 +1112,7 @@ module MailinatorClient
     # access token to call this action.
     #
     # Parameters:
-    # *  {string} domainId - The Domain name or the Domain id
+    # *  {string} domainId - The Domain name or simply 'private'
     # *  {string} inbox - The Inbox name
     #
     # Responses: