mailslurp_client 8.2.2 → 8.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93232136e472641c4912032ba0ed4bc7f3c78ef341733304a196f3905e8cbd6b
-  data.tar.gz: 10105fc33f340605cd60c26f8394cec9cdc3446866aff735ccd2d9111069d032
+  metadata.gz: c939cc4a13acdfa00befd57219f03fb5043cfcd59388d515edb4fb998a5b6d79
+  data.tar.gz: 0e2a9812fe11d95e8cf0fff0a529ab013a502ed09fb801088efb5cebeddea021
 SHA512:
-  metadata.gz: 2d13af2cffe00a7e7b1916e1e676a6a338e4559f9a1dc306212be8b026d60039afc03622ddd8e03096dff79988bb5adbd3f0b270274889521e19ee5f54e7edf0
-  data.tar.gz: 102c0544b57ffd544cba06e9feadd9771470daa8c834aeebb8a3b6e17a21910d4497852a20e4c35985a17b5aa26fc2b39d5a7e3d6df4745c2d93afad766f38e3
+  metadata.gz: 9ec7920d5f89318fb2dc9dd36ee6c1f862e56d78fb7ec3b5d1db19f528f04fa7b494b0d20e1eee66953ccc115e569b4844ac020df7f2634e479bde828753b0ee
+  data.tar.gz: 6a10885e285042aaf67a7ce890b512bea25205b358a2e0e3b84a2361e38e021ff81c3e04649ed246a7fc43e55eb9c18684c0682caf57e1038b9ea5f3167be6f0

data/README.md

@@ -13,11 +13,13 @@ MailSlurp is an email API service that lets you create real email addresses in c
 ## Get started
 
 ::: tip
+
 This section describes how to get up and running with the Ruby client.
 
 See the [examples page](https://www.mailslurp.com/examples/) for more examples and use with common frameworks such as Rails and RSpec.
 
 See the method documentation for a [list of all functions](./docs)
+
 :::
 
 ### Create API Key
@@ -39,15 +41,23 @@ gem install mailslurp_client
 Or in your `Gemfile`:
 
 ```ruby
-gem 'mailslurp_client', '~> 7.0', '>= 7.0.8'
+gem 'mailslurp_client', '~> 8.2', '>= 8.2.2'
+```
+
+And then run bundler install:
+
+```bash
+gem install bundler
+bundle install
 ```
 
+
 ### Configure the client
 
 ```ruby
 require 'mailslurp_client'
 
-# configure the mailslurp client with an API Key
+# configure mailslurp client globally with API key (or pass each controller a client instance)
 MailSlurpClient.configure do |config|
     config.api_key['x-api-key'] = "YOUR_API_KEY_HERE"
 end
@@ -80,6 +90,26 @@ it 'can create email addresses' do
 end
 ```
 
+### List inboxes
+
+Inboxes you create can be listed in a paginated way.
+
+```ruby
+it 'can list inboxes' do
+    inbox_controller = MailSlurpClient::InboxControllerApi.new
+    paged_inboxes = inbox_controller.get_all_inboxes({ page: 0, size: 20 })
+
+    # assert on pagination fields
+    expect(paged_inboxes.content).not_to be_empty
+    expect(paged_inboxes.number).to be(0)
+    expect(paged_inboxes.size).to be(20)
+
+    # can access inbox result
+    expect(paged_inboxes.content[0].id).not_to be_empty
+end
+```
+
+
 ### Send emails
 
 You can send HTML emails easily with the inbox controller. First create an inbox then use its ID with the `send_email` method.
@@ -104,6 +134,24 @@ inbox_controller.send_email(inbox.id, {
 })
 ```
 
+You can also use objects for most method options:
+
+```ruby
+# for send options see https://github.com/mailslurp/mailslurp-client-ruby/blob/master/docs/SendEmailOptions.md
+opts = {
+  send_email_options: MailSlurpClient::SendEmailOptions.new(
+    {
+      to: [inbox_2.email_address],
+      subject: 'Test email',
+      from: inbox_1.email_address,
+      body: 'Test email content',
+      is_html: true,
+      attachments: attachment_ids
+    }
+  )
+}
+inbox_controller.send_email(inbox_1.id, opts)
+```
 ### Receive emails
 
 You can use MailSlurp to wait for at least 1 unread email in an inbox and return it.
@@ -111,13 +159,161 @@ If a timeout is exceeded it will throw an error instead:
 
 ```ruby
 waitfor_controller = MailSlurpClient::WaitForControllerApi.new
-email = waitfor_controller.wait_for_latest_email({ inbox_id: inbox.id, unread_only: true })
+email = waitfor_controller.wait_for_latest_email({ inbox_id: inbox.id, unread_only: true, timeout: 30_000 })
 
 # verify email contents
 expect(email.subject).to include("Test")
 expect(email.body).to include("Your email body")
 ```
 
+### Attachments
+
+You can send attachments by first uploading files with the `AttachmentControllerApi` then using the returned attachment IDs in the send email method.
+
+::: tip
+
+MailSlurp endpoints use base64 string encoding for upload and download files. To encode or decode strings in Ruby make sure you use the **strict** variables that avoid added newlines.
+
+:::
+
+#### Upload and send
+```ruby
+# upload a file to mailslurp to use as attachment
+# @return [Array<String>]
+def upload_file
+# read a file to upload
+data = File.open(PATH_TO_ATTACHMENT).read
+
+# encode the data as base64 string (must be strict to avoid ruby adding new line characters)
+encoded = Base64.strict_encode64(data)
+
+attachment_controller = MailSlurpClient::AttachmentControllerApi.new
+upload_options = MailSlurpClient::UploadAttachmentOptions.new(
+  {
+    base64_contents: encoded,
+    content_type: 'text/plain',
+    filename: 'attachment.txt'
+  }
+)
+
+# return list of attachment ids
+attachment_controller.upload_attachment(upload_options)
+end
+```
+
+To send attachments
+
+```ruby
+attachment_ids = upload_file
+
+opts = {
+  send_email_options: MailSlurpClient::SendEmailOptions.new(
+    {
+      to: [inbox_2.email_address],
+      subject: 'Test email',
+      from: inbox_1.email_address,
+      body: 'Test email content',
+      is_html: true,
+      attachments: attachment_ids
+    }
+  )
+}
+inbox_controller.send_email(inbox_1.id, opts)
+```
+
+#### Download received attachments
+```ruby
+ # wait for the email to arrive (or fetch directly using email controller if you know it is there)
+wait_opts = {
+  inbox_id: inbox_2.id,
+  timeout: 30_000,
+  unread_only: true
+}
+email = wait_controller.wait_for_latest_email(wait_opts)
+
+# find the attachments on the email object
+expect(email.attachments.size).to be(1)
+
+# download the attachment
+email_controller = MailSlurpClient::EmailControllerApi.new
+downloaded_attachment = email_controller.download_attachment_base64(email.attachments[0], email.id)
+
+# extract attachment content
+expect(downloaded_attachment.content_type).to eq("text/plain")
+expect(downloaded_attachment.size_bytes).to be_truthy
+expect(downloaded_attachment.base64_file_contents).to be_truthy
+```
+
+## Examples
+
+### Send email between two inboxes
+
+It is common to use MailSlurp in test environments. Here is an example RSpec test:
+
+```ruby
+
+require 'mailslurp_client'
+
+# read mailslurp api key from environment variables
+API_KEY = ENV['API_KEY']
+
+describe 'use MailSlurp ruby sdk to create email addresses then send and receive email' do
+  before(:all) do
+    expect(API_KEY).to be_truthy
+
+    # configure mailslurp with API key
+    MailSlurpClient.configure do |config|
+      config.api_key['x-api-key'] = API_KEY
+    end
+  end
+
+  it 'can an inbox with an email address' do
+    # create a new email address
+    inbox_controller = MailSlurpClient::InboxControllerApi.new
+    inbox = inbox_controller.create_inbox
+
+    # has a mailslurp email address
+    expect(inbox.id).to be_truthy
+    expect(inbox.email_address).to include('@mailslurp.com')
+  end
+
+  it 'can send and receive emails' do
+    inbox_controller = MailSlurpClient::InboxControllerApi.new
+    wait_controller  = MailSlurpClient::WaitForControllerApi.new
+
+    # create two inboxes
+    inbox_1 = inbox_controller.create_inbox
+    inbox_2 = inbox_controller.create_inbox
+
+    # send email from inbox 1 to inbox 2 (you can send emails to any address)
+    # for send options see https://github.com/mailslurp/mailslurp-client-ruby/blob/master/docs/SendEmailOptions.md
+    opts = {
+      send_email_options: MailSlurpClient::SendEmailOptions.new(
+        {
+          to: [inbox_2.email_address],
+          subject: 'Test email',
+          from: inbox_1.email_address,
+          body: 'Test email content',
+          is_html: true
+        }
+      )
+    }
+    inbox_controller.send_email(inbox_1.id, opts)
+
+    expect(inbox_2.id).to be_truthy
+
+    # now wait for the email to arrive
+    wait_opts = {
+      inbox_id: inbox_2.id,
+      timeout: 30_000,
+      unread_only: true
+    }
+    email = wait_controller.wait_for_latest_email(wait_opts)
+    expect(email.body).to include('Test email content')
+  end
+end
+```
+
 ## SDK Documentation
 
 See the [examples page](https://www.mailslurp.com/examples/) or the full [Method Documentation](./docs) on Github.

data/lib/mailslurp_client/api/attachment_controller_api.rb

@@ -19,8 +19,8 @@ module MailSlurpClient
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Upload an attachment for sending
-    # When sending emails with attachments first upload each attachment with this endpoint. Record the returned attachment IDs. Then use these attachment IDs in the SendEmailOptions when sending an email. This means that attachments can easily be reused.
+    # Upload an attachment for sending using base64 file encoding. Returns an array whose first element is the ID of the uploaded attachment.
+    # When sending emails with attachments first upload each attachment with an upload endpoint. Record the returned attachment IDs. For legacy reasons the ID is returned in an array. Only a single ID is ever returned at one time. To send the attachments pass a list of attachment IDs with SendEmailOptions when sending an email. Using the upload endpoints prior to sending mean attachments can easily be reused.
     # @param upload_options [UploadAttachmentOptions] uploadOptions
     # @param [Hash] opts the optional parameters
     # @return [Array<String>]
@@ -29,8 +29,8 @@ module MailSlurpClient
       data
     end
 
-    # Upload an attachment for sending
-    # When sending emails with attachments first upload each attachment with this endpoint. Record the returned attachment IDs. Then use these attachment IDs in the SendEmailOptions when sending an email. This means that attachments can easily be reused.
+    # Upload an attachment for sending using base64 file encoding. Returns an array whose first element is the ID of the uploaded attachment.
+    # When sending emails with attachments first upload each attachment with an upload endpoint. Record the returned attachment IDs. For legacy reasons the ID is returned in an array. Only a single ID is ever returned at one time. To send the attachments pass a list of attachment IDs with SendEmailOptions when sending an email. Using the upload endpoints prior to sending mean attachments can easily be reused.
     # @param upload_options [UploadAttachmentOptions] uploadOptions
     # @param [Hash] opts the optional parameters
     # @return [Array<(Array<String>, Integer, Hash)>] Array<String> data, response status code and response headers
@@ -83,26 +83,92 @@ module MailSlurpClient
       return data, status_code, headers
     end
 
-    # Upload an attachment for sending using Multipart Form
-    # When sending emails with attachments first upload each attachment with this endpoint. Record the returned attachment IDs. Then use these attachment IDs in the SendEmailOptions when sending an email. This means that attachments can easily be reused.
+    # Upload an attachment for sending using file byte stream input octet stream. Returns an array whose first element is the ID of the uploaded attachment.
+    # When sending emails with attachments first upload each attachment with an upload endpoint. Record the returned attachment IDs. For legacy reasons the ID is returned in an array. Only a single ID is ever returned at one time. To send the attachments pass a list of attachment IDs with SendEmailOptions when sending an email. Using the upload endpoints prior to sending mean attachments can easily be reused.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :string Optional contentType for file. For instance &#x60;application/pdf&#x60;
+    # @option opts [String] :filename Optional filename to save upload with
+    # @option opts [String] :byte_array Byte array request body
+    # @return [Array<String>]
+    def upload_attachment_bytes(opts = {})
+      data, _status_code, _headers = upload_attachment_bytes_with_http_info(opts)
+      data
+    end
+
+    # Upload an attachment for sending using file byte stream input octet stream. Returns an array whose first element is the ID of the uploaded attachment.
+    # When sending emails with attachments first upload each attachment with an upload endpoint. Record the returned attachment IDs. For legacy reasons the ID is returned in an array. Only a single ID is ever returned at one time. To send the attachments pass a list of attachment IDs with SendEmailOptions when sending an email. Using the upload endpoints prior to sending mean attachments can easily be reused.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :string Optional contentType for file. For instance &#x60;application/pdf&#x60;
+    # @option opts [String] :filename Optional filename to save upload with
+    # @option opts [String] :byte_array Byte array request body
+    # @return [Array<(Array<String>, Integer, Hash)>] Array<String> data, response status code and response headers
+    def upload_attachment_bytes_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AttachmentControllerApi.upload_attachment_bytes ...'
+      end
+      # resource path
+      local_var_path = '/attachments/bytes'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'String'] = opts[:'string'] if !opts[:'string'].nil?
+      query_params[:'filename'] = opts[:'filename'] if !opts[:'filename'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/octet-stream'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] || @api_client.object_to_http_body(opts[:'byte_array']) 
+
+      # return_type
+      return_type = opts[:return_type] || 'Array<String>' 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['API_KEY']
+
+      new_options = opts.merge(
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AttachmentControllerApi#upload_attachment_bytes\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Upload an attachment for sending using a Multipart Form request. Returns an array whose first element is the ID of the uploaded attachment.
+    # When sending emails with attachments first upload each attachment with an upload endpoint. Record the returned attachment IDs. For legacy reasons the ID is returned in an array. Only a single ID is ever returned at one time. To send the attachments pass a list of attachment IDs with SendEmailOptions when sending an email. Using the upload endpoints prior to sending mean attachments can easily be reused.
     # @param file [File] file
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :content_type contentType
-    # @option opts [String] :filename filename
-    # @option opts [String] :x_filename x-filename
+    # @option opts [String] :content_type Optional content type of attachment
+    # @option opts [String] :filename Optional name of file
+    # @option opts [String] :x_filename Optional content type header of attachment
     # @return [Array<String>]
     def upload_multipart_form(file, opts = {})
       data, _status_code, _headers = upload_multipart_form_with_http_info(file, opts)
       data
     end
 
-    # Upload an attachment for sending using Multipart Form
-    # When sending emails with attachments first upload each attachment with this endpoint. Record the returned attachment IDs. Then use these attachment IDs in the SendEmailOptions when sending an email. This means that attachments can easily be reused.
+    # Upload an attachment for sending using a Multipart Form request. Returns an array whose first element is the ID of the uploaded attachment.
+    # When sending emails with attachments first upload each attachment with an upload endpoint. Record the returned attachment IDs. For legacy reasons the ID is returned in an array. Only a single ID is ever returned at one time. To send the attachments pass a list of attachment IDs with SendEmailOptions when sending an email. Using the upload endpoints prior to sending mean attachments can easily be reused.
     # @param file [File] file
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :content_type contentType
-    # @option opts [String] :filename filename
-    # @option opts [String] :x_filename x-filename
+    # @option opts [String] :content_type Optional content type of attachment
+    # @option opts [String] :filename Optional name of file
+    # @option opts [String] :x_filename Optional content type header of attachment
     # @return [Array<(Array<String>, Integer, Hash)>] Array<String> data, response status code and response headers
     def upload_multipart_form_with_http_info(file, opts = {})
       if @api_client.config.debugging

data/lib/mailslurp_client/api/email_controller_api.rb

@@ -75,7 +75,7 @@ module MailSlurpClient
 
     # Delete an email
     # Deletes an email and removes it from the inbox. Deleted emails cannot be recovered.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email to delete
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def delete_email(email_id, opts = {})
@@ -85,7 +85,7 @@ module MailSlurpClient
 
     # Delete an email
     # Deletes an email and removes it from the inbox. Deleted emails cannot be recovered.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email to delete
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_email_with_http_info(email_id, opts = {})
@@ -135,8 +135,8 @@ module MailSlurpClient
 
     # Get email attachment bytes. If you have trouble with byte responses try the `downloadAttachmentBase64` response endpoints.
     # Returns the specified attachment for a given email as a stream / array of bytes. You can find attachment ids in email responses endpoint responses. The response type is application/octet-stream.
-    # @param attachment_id [String] attachmentId
-    # @param email_id [String] emailId
+    # @param attachment_id [String] ID of attachment
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @option opts [String] :api_key Can pass apiKey in url for this request if you wish to download the file in a browser. Content type will be set to original content type of the attachment file. This is so that browsers can download the file correctly.
     # @return [String]
@@ -147,8 +147,8 @@ module MailSlurpClient
 
     # Get email attachment bytes. If you have trouble with byte responses try the &#x60;downloadAttachmentBase64&#x60; response endpoints.
     # Returns the specified attachment for a given email as a stream / array of bytes. You can find attachment ids in email responses endpoint responses. The response type is application/octet-stream.
-    # @param attachment_id [String] attachmentId
-    # @param email_id [String] emailId
+    # @param attachment_id [String] ID of attachment
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @option opts [String] :api_key Can pass apiKey in url for this request if you wish to download the file in a browser. Content type will be set to original content type of the attachment file. This is so that browsers can download the file correctly.
     # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
@@ -206,8 +206,8 @@ module MailSlurpClient
 
     # Get email attachment as base64 encoded string (alternative to binary responses)
     # Returns the specified attachment for a given email as a base 64 encoded string. The response type is application/json. This method is similar to the `downloadAttachment` method but allows some clients to get around issues with binary responses.
-    # @param attachment_id [String] attachmentId
-    # @param email_id [String] emailId
+    # @param attachment_id [String] ID of attachment
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [DownloadAttachmentDto]
     def download_attachment_base64(attachment_id, email_id, opts = {})
@@ -217,8 +217,8 @@ module MailSlurpClient
 
     # Get email attachment as base64 encoded string (alternative to binary responses)
     # Returns the specified attachment for a given email as a base 64 encoded string. The response type is application/json. This method is similar to the &#x60;downloadAttachment&#x60; method but allows some clients to get around issues with binary responses.
-    # @param attachment_id [String] attachmentId
-    # @param email_id [String] emailId
+    # @param attachment_id [String] ID of attachment
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [Array<(DownloadAttachmentDto, Integer, Hash)>] DownloadAttachmentDto data, response status code and response headers
     def download_attachment_base64_with_http_info(attachment_id, email_id, opts = {})
@@ -274,7 +274,7 @@ module MailSlurpClient
 
     # Forward email
     # Forward an existing email to new recipients.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param forward_email_options [ForwardEmailOptions] forwardEmailOptions
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -285,7 +285,7 @@ module MailSlurpClient
 
     # Forward email
     # Forward an existing email to new recipients.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param forward_email_options [ForwardEmailOptions] forwardEmailOptions
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -342,8 +342,8 @@ module MailSlurpClient
 
     # Get email attachment metadata
     # Returns the metadata such as name and content-type for a given attachment and email.
-    # @param attachment_id [String] attachmentId
-    # @param email_id [String] emailId
+    # @param attachment_id [String] ID of attachment
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [AttachmentMetaData]
     def get_attachment_meta_data(attachment_id, email_id, opts = {})
@@ -353,8 +353,8 @@ module MailSlurpClient
 
     # Get email attachment metadata
     # Returns the metadata such as name and content-type for a given attachment and email.
-    # @param attachment_id [String] attachmentId
-    # @param email_id [String] emailId
+    # @param attachment_id [String] ID of attachment
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [Array<(AttachmentMetaData, Integer, Hash)>] AttachmentMetaData data, response status code and response headers
     def get_attachment_meta_data_with_http_info(attachment_id, email_id, opts = {})
@@ -410,7 +410,7 @@ module MailSlurpClient
 
     # Get all email attachment metadata
     # Returns an array of attachment metadata such as name and content-type for a given email if present.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [Array<AttachmentMetaData>]
     def get_attachments(email_id, opts = {})
@@ -420,7 +420,7 @@ module MailSlurpClient
 
     # Get all email attachment metadata
     # Returns an array of attachment metadata such as name and content-type for a given email if present.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [Array<(Array<AttachmentMetaData>, Integer, Hash)>] Array<AttachmentMetaData> data, response status code and response headers
     def get_attachments_with_http_info(email_id, opts = {})
@@ -677,7 +677,7 @@ module MailSlurpClient
 
     # Get raw email string
     # Returns a raw, unparsed, and unprocessed email. If your client has issues processing the response it is likely due to the response content-type which is text/plain. If you need a JSON response content-type use the getRawEmailJson endpoint
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [String]
     def get_raw_email_contents(email_id, opts = {})
@@ -687,7 +687,7 @@ module MailSlurpClient
 
     # Get raw email string
     # Returns a raw, unparsed, and unprocessed email. If your client has issues processing the response it is likely due to the response content-type which is text/plain. If you need a JSON response content-type use the getRawEmailJson endpoint
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [Array<(String, Integer, Hash)>] String data, response status code and response headers
     def get_raw_email_contents_with_http_info(email_id, opts = {})
@@ -739,7 +739,7 @@ module MailSlurpClient
 
     # Get raw email in JSON
     # Returns a raw, unparsed, and unprocessed email wrapped in a JSON response object for easier handling when compared with the getRawEmail text/plain response
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [RawEmailJson]
     def get_raw_email_json(email_id, opts = {})
@@ -749,7 +749,7 @@ module MailSlurpClient
 
     # Get raw email in JSON
     # Returns a raw, unparsed, and unprocessed email wrapped in a JSON response object for easier handling when compared with the getRawEmail text/plain response
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [Array<(RawEmailJson, Integer, Hash)>] RawEmailJson data, response status code and response headers
     def get_raw_email_json_with_http_info(email_id, opts = {})
@@ -857,7 +857,7 @@ module MailSlurpClient
 
     # Validate email
     # Validate the HTML content of email if HTML is found. Considered valid if no HTML.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [ValidationDto]
     def validate_email(email_id, opts = {})
@@ -867,7 +867,7 @@ module MailSlurpClient
 
     # Validate email
     # Validate the HTML content of email if HTML is found. Considered valid if no HTML.
-    # @param email_id [String] emailId
+    # @param email_id [String] ID of email
     # @param [Hash] opts the optional parameters
     # @return [Array<(ValidationDto, Integer, Hash)>] ValidationDto data, response status code and response headers
     def validate_email_with_http_info(email_id, opts = {})

data/lib/mailslurp_client/models/upload_attachment_options.rb

@@ -15,7 +15,7 @@ require 'date'
 module MailSlurpClient
   # Options for uploading files for attachments. When sending emails with the API that require attachments first upload each attachment. Then use the returned attachment ID in your `SendEmailOptions` when sending an email. This way you can use attachments multiple times once they have been uploaded.
   class UploadAttachmentOptions
-    # Base64 encoded string of file contents
+    # Base64 encoded string of file contents. Typically this means reading the bytes or string content of a file and then converting that to a base64 encoded string.
     attr_accessor :base64_contents
 
     # Optional contentType for file. For instance `application/pdf`

data/lib/mailslurp_client/version.rb

@@ -11,5 +11,5 @@ OpenAPI Generator version: 4.3.1
 =end
 
 module MailSlurpClient
-  VERSION = '8.2.2'
+  VERSION = '8.2.8'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailslurp_client
 version: !ruby/object:Gem::Version
-  version: 8.2.2
+  version: 8.2.8
 platform: ruby
 authors:
 - mailslurp
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-11-19 00:00:00.000000000 Z
+date: 2020-11-20 00:00:00.000000000 Z
 dependencies: []
 description: Create emails addresses in Ruby then send and receive real emails and
   attachments. See https://www.mailslurp.com/docs/ruby/ for full Ruby documentation.