add sub account deletion

README.md

@@ -211,6 +211,7 @@ General:
 - API Tokens API – [`api_tokens_api.rb`](examples/api_tokens_api.rb)
 - Billing API – [`billing_api.rb`](examples/billing_api.rb)
 - Permissions API – [`permissions_api.rb`](examples/permissions_api.rb)
+- Sub Accounts API (list, create, delete) – [`sub_accounts_api.rb`](examples/sub_accounts_api.rb)
 - Templates API – [`email_templates_api.rb`](examples/email_templates_api.rb)
 - Action Mailer – [`action_mailer.rb`](examples/action_mailer.rb)
 - Verifying webhook signatures – [`webhooks_signature_verification.ru`](examples/webhooks_signature_verification.ru)

examples/sub_accounts_api.rb

@@ -11,3 +11,7 @@
 # Create a new sub account
 sub_accounts.create(name: 'New Team Account')
 # => #<struct Mailtrap::SubAccount id=12347, name="New Team Account">
+
+# Delete a sub account
+sub_accounts.delete(12_347)
+# => nil

lib/mailtrap/sub_accounts_api.rb

@@ -40,6 +40,19 @@ def create(options)
       base_create(options)
     end
 
+    # Permanently deletes a sub account under the organization
+    #
+    # Requires sub account management permissions for the organization. The deletion is permanent
+    # and removes all data of the sub account. Deleting the last sub account also deletes the organization.
+    # A repeated call for the same sub account returns a 404 error.
+    # Rate limit: 10 requests per minute per organization.
+    # @param sub_account_id [Integer] The sub account ID
+    # @return nil
+    # @!macro api_errors
+    def delete(sub_account_id)
+      base_delete(sub_account_id)
+    end
+
     private
 
     def base_path

spec/mailtrap/sub_accounts_api_spec.rb

@@ -54,4 +54,26 @@
       end
     end
   end
+
+  describe '#delete' do
+    subject(:delete) { sub_accounts_api.delete(sub_account_id) }
+
+    let(:sub_account_id) { 2_704_237 }
+
+    it 'returns nil on success' do
+      expect(delete).to be_nil
+    end
+
+    context 'when sub account does not exist' do
+      let(:sub_account_id) { -1 }
+
+      it 'raises not found error' do
+        expect { delete }.to raise_error do |error|
+          expect(error).to be_a(Mailtrap::Error)
+          expect(error.message).to include('Not Found')
+          expect(error.messages.any? { |msg| msg.include?('Not Found') }).to be true
+        end
+      end
+    end
+  end
 end