From 09d3d11b3488d948019914697957bded64c6c83e Mon Sep 17 00:00:00 2001
From: DagonWat <yahor.vaitsiakhouski@railsware.com>
Date: Fri, 13 Mar 2026 12:30:35 +0100
Subject: [PATCH 1/2] MT-20050: Add new examples

---
 specs/account-management.openapi.yml |  46 ++++++
 specs/email-sending.openapi.yml      |  96 ++++++++++++
 specs/sandbox.openapi.yml            | 222 +++++++++++++++++++++++++++
 3 files changed, 364 insertions(+)

diff --git a/specs/account-management.openapi.yml b/specs/account-management.openapi.yml
index 3cbcb6c..240090d 100644
--- a/specs/account-management.openapi.yml
+++ b/specs/account-management.openapi.yml
@@ -95,6 +95,18 @@ paths:
                 print(f"Account: {account.name}")
                 print(f"ID: {account.id}")
                 print(f"Access Level: {account.access_levels[0]}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            accounts = Mailtrap::AccountsAPI.new(client)
+
+            accounts.list.each do |account|
+              puts "Account: #{account.name}"
+              puts "ID: #{account.id}"
+            end
         - lang: csharp
           label: .NET
           source: |
@@ -212,6 +224,22 @@ paths:
             accesses = client.general_api.account_accesses.get_list(account_id)
             for access in accesses:
                 print(f"User: {access.specifier.email}, Level: {access.permission_level}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            account_accesses = Mailtrap::AccountAccessesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            account_accesses.list.each do |access|
+              puts access.specifier
+            end
+
+            # With optional filters
+            account_accesses.list(domain_ids: [1, 2])
+            account_accesses.list(inbox_ids: [12, 34])
+            account_accesses.list(project_ids: [100, 200])
         - lang: csharp
           label: C#
           source: |
@@ -326,6 +354,15 @@ paths:
 
             client = mt.MailtrapClient(token="YOUR_API_KEY")
             client.general_api.account_accesses.delete(account_id, access_id)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            account_accesses = Mailtrap::AccountAccessesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            account_accesses.delete(ACCOUNT_ACCESS_ID)
         - lang: csharp
           label: C#
           source: |
@@ -881,6 +918,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY")
             usage = client.general_api.billing.get_current_billing_usage(account_id)
             print(f"Sandbox sent: {usage.testing.usage.sent_messages_count.current}/{usage.testing.usage.sent_messages_count.limit}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            billing = Mailtrap::BillingAPI.new(YOUR_ACCOUNT_ID, client)
+
+            billing.usage
         - lang: csharp
           label: C#
           source: |
diff --git a/specs/email-sending.openapi.yml b/specs/email-sending.openapi.yml
index 83c216f..feeed17 100644
--- a/specs/email-sending.openapi.yml
+++ b/specs/email-sending.openapi.yml
@@ -121,6 +121,17 @@ paths:
             domain = client.sending_domains_api.sending_domains.create(params)
 
             print(f"Created domain: {domain}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            sending_domains = Mailtrap::SendingDomainsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            domain = sending_domains.create(domain_name: 'example.com')
+
+            puts "Created domain: #{domain.name}"
         - lang: csharp
           label: .NET
           source: |
@@ -253,6 +264,17 @@ paths:
 
             for domain in domains:
                 print(f"Domain: {domain.domain_name}, Verified: {domain.dns_verified}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            sending_domains = Mailtrap::SendingDomainsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            sending_domains.list.each do |domain|
+              puts "Domain: #{domain.name}"
+            end
         - lang: csharp
           label: .NET
           source: |
@@ -360,6 +382,17 @@ paths:
 
             print(f"Domain: {domain.domain_name}")
             print(f"DNS Verified: {domain.dns_verified}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            sending_domains = Mailtrap::SendingDomainsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            domain = sending_domains.get(DOMAIN_ID)
+
+            puts "Domain: #{domain.name}"
         - lang: csharp
           label: .NET
           source: |
@@ -464,6 +497,15 @@ paths:
             client.sending_domains_api.sending_domains.delete(domain_id)
 
             print("Domain deleted successfully")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            sending_domains = Mailtrap::SendingDomainsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            sending_domains.delete(DOMAIN_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -583,6 +625,15 @@ paths:
             )
 
             print("Setup instructions sent")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            sending_domains = Mailtrap::SendingDomainsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            sending_domains.send_setup_instructions(DOMAIN_ID, email: 'devops@example.com')
         - lang: csharp
           label: .NET
           source: |
@@ -980,6 +1031,15 @@ paths:
           source: |
             curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/stats?start_date=2025-01-01&end_date=2025-12-31' \
               -H 'Authorization: Bearer YOUR_API_KEY'
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            stats.get(start_date: '2026-01-01', end_date: '2026-01-31')
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1016,6 +1076,15 @@ paths:
           source: |
             curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/stats/domains?start_date=2025-01-01&end_date=2025-12-31' \
               -H 'Authorization: Bearer YOUR_API_KEY'
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            stats.by_domain(start_date: '2026-01-01', end_date: '2026-01-31')
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1061,6 +1130,15 @@ paths:
           source: |
             curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/stats/categories?start_date=2025-01-01&end_date=2025-12-31' \
               -H 'Authorization: Bearer YOUR_API_KEY'
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            stats.by_category(start_date: '2026-01-01', end_date: '2026-01-31')
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1105,6 +1183,15 @@ paths:
           source: |
             curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/stats/email_service_providers?start_date=2025-01-01&end_date=2025-12-31' \
               -H 'Authorization: Bearer YOUR_API_KEY'
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            stats.by_email_service_provider(start_date: '2026-01-01', end_date: '2026-01-31')
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1149,6 +1236,15 @@ paths:
           source: |
             curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/stats/date?start_date=2025-01-01&end_date=2025-12-31' \
               -H 'Authorization: Bearer YOUR_API_KEY'
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
+
+            stats.by_date(start_date: '2026-01-01', end_date: '2026-01-31')
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
diff --git a/specs/sandbox.openapi.yml b/specs/sandbox.openapi.yml
index a3d9179..26454f8 100644
--- a/specs/sandbox.openapi.yml
+++ b/specs/sandbox.openapi.yml
@@ -120,6 +120,17 @@ paths:
             inboxes = inboxes_api.get_list()
 
             print(inboxes)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inboxes.list.each do |inbox|
+              puts "Inbox: #{inbox.name} (ID: #{inbox.id})"
+            end
         - lang: csharp
           label: .NET
           source: |
@@ -919,6 +930,17 @@ paths:
 
             print(f"Inbox created: {inbox.name}")
             print(f"SMTP credentials - User: {inbox.username}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inbox = inboxes.create(name: 'My Test Inbox', project_id: PROJECT_ID)
+
+            puts "Inbox created: #{inbox.name}"
         - lang: csharp
           label: .NET
           source: |
@@ -1034,6 +1056,15 @@ paths:
             inbox_attributes = inboxes_api.get_by_id(inbox_id)
 
             print(inbox_attributes)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inbox = inboxes.get(INBOX_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -1136,6 +1167,15 @@ paths:
             result = inboxes_api.delete(inbox_id)
 
             print(result)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inboxes.delete(INBOX_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -1273,6 +1313,15 @@ paths:
             )
 
             print(updated_inbox)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inboxes.update(INBOX_ID, name: 'Updated Inbox Name')
         - lang: csharp
           label: .NET
           source: |
@@ -1393,6 +1442,15 @@ paths:
             result = inboxes_api.clean(inbox_id)
 
             print(result)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inboxes.clean(INBOX_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -1501,6 +1559,15 @@ paths:
             result = inboxes_api.mark_as_read(inbox_id)
 
             print(result)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inboxes.mark_as_read(INBOX_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -1609,6 +1676,15 @@ paths:
             result = inboxes_api.reset_credentials(inbox_id)
 
             print(result)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
+
+            inboxes.reset_credentials(INBOX_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -1979,6 +2055,15 @@ paths:
             message = messages_api.show_message(inbox_id=inbox_id, message_id=message_id)
 
             print(message)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            message = messages.get(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -2212,6 +2297,15 @@ paths:
             )
 
             print(updated_message)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.mark_as_read(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -2419,6 +2513,15 @@ paths:
             result = messages_api.delete(inbox_id=inbox_id, message_id=message_id)
 
             print(result)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.delete(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -2630,6 +2733,22 @@ paths:
                 print(f"From: {message.from_email}")
                 print(f"Subject: {message.subject}")
                 print(f"Received: {message.created_at}")
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.list.each do |message|
+              puts "From: #{message.from_email}"
+              puts "Subject: #{message.subject}"
+            end
+
+            # With search and pagination
+            messages.list(search: 'welcome')
+            messages.list(page: 2)
         - lang: csharp
           label: .NET
           source: |
@@ -2811,6 +2930,15 @@ paths:
             )
 
             print(result)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.forward_message(MESSAGE_ID, email: 'recipient@example.com')
         - lang: csharp
           label: .NET
           source: |
@@ -2973,6 +3101,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             spam_report = client.testing_api.messages.get_spam_report(inbox_id=12345, message_id=67890)
             print(spam_report)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.spam_score(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3147,6 +3284,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             html_analysis = client.testing_api.messages.get_html_analysis(inbox_id=12345, message_id=67890)
             print(html_analysis)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.html_analysis(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3270,6 +3416,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             text_body = client.testing_api.messages.get_text_message(inbox_id=12345, message_id=67890)
             print(text_body)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.text_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3437,6 +3592,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             raw_body = client.testing_api.messages.get_raw_message(inbox_id=12345, message_id=67890)
             print(raw_body)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.raw_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3579,6 +3743,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             html_source = client.testing_api.messages.get_html_source(inbox_id=12345, message_id=67890)
             print(html_source)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.html_source(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3725,6 +3898,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             html_body = client.testing_api.messages.get_html_message(inbox_id=12345, message_id=67890)
             print(html_body)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.html_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3892,6 +4074,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             eml_content = client.testing_api.messages.get_message_as_eml(inbox_id=12345, message_id=67890)
             print(eml_content)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.eml_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -4010,6 +4201,15 @@ paths:
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             mail_headers = client.testing_api.messages.get_mail_headers(inbox_id=12345, message_id=67890)
             print(mail_headers)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
+
+            messages.mail_headers(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -4164,6 +4364,17 @@ paths:
             import mailtrap as mt
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             attachments = client.testing_api.attachments.get_list(inbox_id=12345, message_id=67890)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            attachments = Mailtrap::SandboxAttachmentsAPI.new(
+              YOUR_ACCOUNT_ID, INBOX_ID, MESSAGE_ID, client
+            )
+
+            attachments.list
         - lang: csharp
           label: C#
           source: |
@@ -4311,6 +4522,17 @@ paths:
             import mailtrap as mt
             client = mt.MailtrapClient(token="YOUR_API_KEY", account_id="YOUR_ACCOUNT_ID")
             attachment = client.testing_api.attachments.get(inbox_id=12345, message_id=67890, attachment_id=222222)
+        - lang: ruby
+          label: Ruby
+          source: |
+            require 'mailtrap'
+
+            client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
+            attachments = Mailtrap::SandboxAttachmentsAPI.new(
+              YOUR_ACCOUNT_ID, INBOX_ID, MESSAGE_ID, client
+            )
+
+            attachments.get(ATTACHMENT_ID)
         - lang: csharp
           label: C#
           source: |

From fd14e1da78a0b741c0b7bb869aa62231241d75a5 Mon Sep 17 00:00:00 2001
From: DagonWat <yahor.vaitsiakhouski@railsware.com>
Date: Mon, 16 Mar 2026 11:12:03 +0100
Subject: [PATCH 2/2] Add more puts messages to correspond to standard

---
 specs/account-management.openapi.yml |  8 ++++----
 specs/contacts.openapi.yml           |  8 ++++++++
 specs/email-sending.openapi.yml      | 10 +++++-----
 specs/sandbox.openapi.yml            | 28 +++++++++++++++-------------
 specs/templates.openapi.yml          |  4 +++-
 5 files changed, 35 insertions(+), 23 deletions(-)

diff --git a/specs/account-management.openapi.yml b/specs/account-management.openapi.yml
index 240090d..789e9a0 100644
--- a/specs/account-management.openapi.yml
+++ b/specs/account-management.openapi.yml
@@ -237,9 +237,9 @@ paths:
             end
 
             # With optional filters
-            account_accesses.list(domain_ids: [1, 2])
-            account_accesses.list(inbox_ids: [12, 34])
-            account_accesses.list(project_ids: [100, 200])
+            puts account_accesses.list(domain_ids: [1, 2])
+            puts account_accesses.list(inbox_ids: [12, 34])
+            puts account_accesses.list(project_ids: [100, 200])
         - lang: csharp
           label: C#
           source: |
@@ -926,7 +926,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             billing = Mailtrap::BillingAPI.new(YOUR_ACCOUNT_ID, client)
 
-            billing.usage
+            puts "Usage: #{billing.usage}"
         - lang: csharp
           label: C#
           source: |
diff --git a/specs/contacts.openapi.yml b/specs/contacts.openapi.yml
index 54c4f92..f0c9e85 100644
--- a/specs/contacts.openapi.yml
+++ b/specs/contacts.openapi.yml
@@ -1073,6 +1073,7 @@ paths:
             import_job = imports.create([
               { email: "user1@example.com", fields: { first_name: "John" }, list_ids_included: [1, 2] }
             ])
+            puts "Import job: #{import_job}"
         - lang: csharp
           label: C#
           source: |
@@ -1193,6 +1194,7 @@ paths:
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             imports = Mailtrap::ContactImportsAPI.new(YOUR_ACCOUNT_ID, client)
             import_status = imports.get(import_id)
+            puts "Import status: #{import_status}"
         - lang: csharp
           label: C#
           source: |
@@ -1292,6 +1294,7 @@ paths:
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             lists = Mailtrap::ContactListsAPI.new(YOUR_ACCOUNT_ID, client)
             all_lists = lists.list
+            puts "Lists: #{all_lists}"
         - lang: csharp
           label: C#
           source: |
@@ -1384,6 +1387,7 @@ paths:
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             lists = Mailtrap::ContactListsAPI.new(YOUR_ACCOUNT_ID, client)
             new_list = lists.create(name: "Customers")
+            puts "List: #{new_list}"
         - lang: csharp
           label: C#
           source: |
@@ -1482,6 +1486,7 @@ paths:
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             lists = Mailtrap::ContactListsAPI.new(YOUR_ACCOUNT_ID, client)
             list = lists.get(list_id)
+            puts "List: #{list}"
         - lang: csharp
           label: C#
           source: |
@@ -1752,6 +1757,7 @@ paths:
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             fields = Mailtrap::ContactFieldsAPI.new(YOUR_ACCOUNT_ID, client)
             all_fields = fields.list
+            puts "All fields: #{all_fields}"
         - lang: csharp
           label: C#
           source: |
@@ -1851,6 +1857,7 @@ paths:
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             fields = Mailtrap::ContactFieldsAPI.new(YOUR_ACCOUNT_ID, client)
             new_field = fields.create(name: "Company", data_type: "text", merge_tag: "company")
+            puts "New field: #{new_field}"
         - lang: csharp
           label: C#
           source: |
@@ -1986,6 +1993,7 @@ paths:
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             fields = Mailtrap::ContactFieldsAPI.new(YOUR_ACCOUNT_ID, client)
             field = fields.get(field_id)
+            puts field
         - lang: csharp
           label: C#
           source: |
diff --git a/specs/email-sending.openapi.yml b/specs/email-sending.openapi.yml
index feeed17..2a9fa8f 100644
--- a/specs/email-sending.openapi.yml
+++ b/specs/email-sending.openapi.yml
@@ -1039,7 +1039,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
 
-            stats.get(start_date: '2026-01-01', end_date: '2026-01-31')
+            puts "Stats: #{stats.get(start_date: '2026-01-01', end_date: '2026-01-31')}"
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1084,7 +1084,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
 
-            stats.by_domain(start_date: '2026-01-01', end_date: '2026-01-31')
+            puts "Stats: #{stats.by_domain(start_date: '2026-01-01', end_date: '2026-01-31')}"
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1138,7 +1138,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
 
-            stats.by_category(start_date: '2026-01-01', end_date: '2026-01-31')
+            puts "Stats: #{stats.by_category(start_date: '2026-01-01', end_date: '2026-01-31')}"
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1191,7 +1191,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
 
-            stats.by_email_service_provider(start_date: '2026-01-01', end_date: '2026-01-31')
+            puts "Stats: #{stats.by_email_service_provider(start_date: '2026-01-01', end_date: '2026-01-31')}"
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
@@ -1244,7 +1244,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             stats = Mailtrap::StatsAPI.new(YOUR_ACCOUNT_ID, client)
 
-            stats.by_date(start_date: '2026-01-01', end_date: '2026-01-31')
+            puts "Stats: #{stats.by_date(start_date: '2026-01-01', end_date: '2026-01-31')}"
       parameters:
         - $ref: '#/components/parameters/account_id'
         - $ref: '#/components/parameters/StartDateQueryFilter'
diff --git a/specs/sandbox.openapi.yml b/specs/sandbox.openapi.yml
index 26454f8..290304c 100644
--- a/specs/sandbox.openapi.yml
+++ b/specs/sandbox.openapi.yml
@@ -1065,6 +1065,7 @@ paths:
             inboxes = Mailtrap::InboxesAPI.new(YOUR_ACCOUNT_ID, client)
 
             inbox = inboxes.get(INBOX_ID)
+            puts "Inbox: #{inbox}"
         - lang: csharp
           label: .NET
           source: |
@@ -2064,6 +2065,7 @@ paths:
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
             message = messages.get(MESSAGE_ID)
+            puts message
         - lang: csharp
           label: .NET
           source: |
@@ -2747,8 +2749,8 @@ paths:
             end
 
             # With search and pagination
-            messages.list(search: 'welcome')
-            messages.list(page: 2)
+            puts messages.list(search: 'welcome')
+            puts messages.list(page: 2)
         - lang: csharp
           label: .NET
           source: |
@@ -2938,7 +2940,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.forward_message(MESSAGE_ID, email: 'recipient@example.com')
+            puts messages.forward_message(MESSAGE_ID, email: 'recipient@example.com')
         - lang: csharp
           label: .NET
           source: |
@@ -3109,7 +3111,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.spam_score(MESSAGE_ID)
+            puts messages.spam_score(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3292,7 +3294,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.html_analysis(MESSAGE_ID)
+            puts messages.html_analysis(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3424,7 +3426,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.text_body(MESSAGE_ID)
+            puts messages.text_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3600,7 +3602,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.raw_body(MESSAGE_ID)
+            puts messages.raw_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3751,7 +3753,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.html_source(MESSAGE_ID)
+            puts messages.html_source(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -3906,7 +3908,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.html_body(MESSAGE_ID)
+            puts messages.html_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -4082,7 +4084,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.eml_body(MESSAGE_ID)
+            puts messages.eml_body(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -4209,7 +4211,7 @@ paths:
             client = Mailtrap::Client.new(api_key: ENV['MAILTRAP_API_KEY'])
             messages = Mailtrap::SandboxMessagesAPI.new(YOUR_ACCOUNT_ID, INBOX_ID, client)
 
-            messages.mail_headers(MESSAGE_ID)
+            puts messages.mail_headers(MESSAGE_ID)
         - lang: csharp
           label: .NET
           source: |
@@ -4374,7 +4376,7 @@ paths:
               YOUR_ACCOUNT_ID, INBOX_ID, MESSAGE_ID, client
             )
 
-            attachments.list
+            puts attachments.list
         - lang: csharp
           label: C#
           source: |
@@ -4532,7 +4534,7 @@ paths:
               YOUR_ACCOUNT_ID, INBOX_ID, MESSAGE_ID, client
             )
 
-            attachments.get(ATTACHMENT_ID)
+            puts "Attachment: #{attachments.get(ATTACHMENT_ID)}"
         - lang: csharp
           label: C#
           source: |
diff --git a/specs/templates.openapi.yml b/specs/templates.openapi.yml
index e3c432e..407e264 100644
--- a/specs/templates.openapi.yml
+++ b/specs/templates.openapi.yml
@@ -85,7 +85,7 @@ paths:
             require 'mailtrap'
             client = Mailtrap::Client.new(api_key: 'YOUR_API_KEY')
             templates = Mailtrap::EmailTemplatesAPI.new(YOUR_ACCOUNT_ID, client)
-            all_templates = templates.list
+            puts templates.list
         - lang: csharp
           label: .NET
           source: |
@@ -212,6 +212,7 @@ paths:
               body_html: '<h1>Welcome {{user_name}}!</h1>',
               body_text: 'Welcome {{user_name}}!'
             )
+            puts "Template: #{template}"
         - lang: csharp
           label: .NET
           source: |
@@ -331,6 +332,7 @@ paths:
               client
             )
             template = templates.get(template_id)
+            puts "Template: #{template}"
       responses:
         '200':
           description: Returns attributes of the email template.