xero-ruby 2.6.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e31ff3c90718184423dc2c2e4eaeb4ce2bc068b3ebad4c94017703e8ecd87e71
-  data.tar.gz: 5d831820660d5eae61a43a1f2c8cfd3ce40a3cbe1721697f657b5b61dc7bea36
+  metadata.gz: 2ae2e1e237fab6b52d50d627b80103dd5dfd23e93a708edcbc99ba0105cce082
+  data.tar.gz: 44b6ee803d4f1e972eb14b1f395e2cd1671168e0fb8aa3bcfff7d6676ef1b1e1
 SHA512:
-  metadata.gz: d283c2e0c4f92da33f7bc16665f4ef67570e5f7eadac0ac80d024b57667845df702d7d71be5664c0118b52d3040c18fc3e16363652fe20f69867ffee79afc5ed
-  data.tar.gz: 65cb61a5b45cbada2376223aa4eef5eb00a161f258b8a07d68556bfa210f7ee982cda44144fecfb3af98b91a3d84ec5f50063e5ab740861d4a2c107d8a991a81
+  metadata.gz: 3ecea5bea8d526518613debfd630dee295a2b2b5fcf436cdad243c8814956a1c63ddaa5cfdedd6c922e59be40310ae43d095bcb4bb79c35a3ae1aa0cf1c6ff51
+  data.tar.gz: 5d205bea89d635e035986f0f585b515e0685a9844f6826f11722f0de5cc876cab330bb2ffcd52205e8c009b876f56d99a90ac4781f4bbead7f3c13caf33e5f81

data/README.md

@@ -1,7 +1,7 @@
 # xero-ruby
 Xero Ruby SDK for OAuth 2.0 generated from [Xero API OpenAPI Spec](https://github.com/XeroAPI/Xero-OpenAPI).
 
-[![RubyGem](https://img.shields.io/badge/xero--ruby%20gem-v2.6.0-brightgreen)](https://rubygems.org/gems/xero-ruby)
+[![RubyGem](https://img.shields.io/badge/xero--ruby%20gem-brightgreen)](https://rubygems.org/gems/xero-ruby)
 
 # Documentation
 Xero Ruby SDK supports Xero's OAuth2.0 authentication and the following Xero API sets.
@@ -51,7 +51,7 @@ gem 'xero-ruby'
 
 ### Creating a Client
 * Get the credential values from an API application at https://developer.xero.com/myapps/.
-* Include [neccesary scopes](https://developer.xero.com/documentation/oauth2/scopes) as comma seperated list
+* Include [neccesary scopes](https://developer.xero.com/documentation/oauth2/scopes) as a space-seperated list
     * example => "`openid profile email accounting.transactions accounting.settings`"
 ```
 require 'xero-ruby'
@@ -138,6 +138,11 @@ connections = xero_client.connections
   "updatedDateUtc" => "2020-04-15T22:37:10.4943410"
 }]
 
+# To completely Revoke a user's access token and all their connections
+# pass in the users token set to the #revoke_token api_client method
+
+xero_client.revoke_token(user.token_set)
+
 # disconnect an org from a user's connections. Pass the connection ['id'] not ['tenantId'].
 # Useful if you want to enforce only a single org connection per token.
 remaining_connections = xero_client.disconnect(connections[0]['id'])
@@ -155,7 +160,7 @@ require 'jwt'
 
 def token_expired?
   token_expiry = Time.at(decoded_access_token['exp'])
-  token_expiry > Time.now
+  token_expiry < Time.now
 end
 
 def decoded_access_token
@@ -183,6 +188,10 @@ accounts = xero_client.accounting_api.get_accounts(tenant_id).accounts
 invoices = { invoices: [{ type: XeroRuby::Accounting::Invoice::ACCREC, contact: { contact_id: contacts[0].contact_id }, line_items: [{ description: "Big Agency", quantity: BigDecimal("2.0"), unit_amount: BigDecimal("50.99"), account_code: "600", tax_type: XeroRuby::Accounting::TaxType::NONE }], date: "2019-03-11", due_date: "2018-12-10", reference: "Website Design", status: XeroRuby::Accounting::Invoice::DRAFT }]}
 invoice = xero_client.accounting_api.create_invoices(tenant_id, invoices).invoices.first
 
+# display out all the serialized data as a hash
+puts invoices.to_attributes
+=> {type: 'ACCREC', line_items: [...]}
+
 # Create History
 payment = xero_client.accounting_api.get_payments(tenant_id).payments.first
 history_records = { history_records: [{ details: "This payment now has some History!" }]}
@@ -295,11 +304,21 @@ opts = {
   order: 'UpdatedDateUtc DESC',
   where: {
     is_customer: ['==', true],
-    is_supplier: ['==', true]
+    is_supplier: ['==', true],
+    name: ['StartsWith', 'Rick']
   }
 }
 xero_client.accounting_api.get_contacts(tenant_id, opts).contacts
 
+# for more complex where filtering that requires a null check, pass those in as a string
+# see https://developer.xero.com/documentation/api/requests-and-responses for more
+
+opts = {
+  where: {
+    email_address: '!=null&&EmailAddress.StartsWith("chris.knight@")'
+  }
+}
+
 # Bank Transactions
 opts = {
   if_modified_since: (DateTime.now - 1.year).to_s,
@@ -324,7 +343,7 @@ xero_client.accounting_api.get_bank_transfers(tenant_id, opts).bank_transfers
 1) Not all `opts` parameter combinations are available for all endpoints, and there are likely some undiscovered edge cases. If you encounter a filter / sort / where clause that seems buggy open an issue and we will dig.
 
 2) Some opts string values may need PascalCasing to match casing defined in our [core API docs](https://developer.xero.com/documentation/api/api-overview).
-    * `opts = { order: 'UpdatedDateUtc DESC'}`
+* `opts = { order: 'UpdatedDateUtc DESC'}`
 
 3) If you have use cases outside of these examples let us know.
 
@@ -341,15 +360,15 @@ Most of the repo code is auto generated but PR's on issues you encounter are hig
 gem build
 mv xero-ruby-<vsn>.gem xero-ruby.gem
 pwd
-=> /Users/chris.knight/code/sdks/xero-ruby/
+=> /Users/your.user/code/sdks/xero-ruby/
 ```
 
-> xero-ruby-oauth2-app
+> https://github.com/XeroAPI/xero-ruby-oauth2-app
 Replace gem file with local path:
 ```bash
-gem 'xero-ruby', path: '/Users/chris.knight/code/sdks/xero-ruby/'
+gem 'xero-ruby', path: '/Users/your.user/code/sdks/xero-ruby/'
 bundle install
 ```
 
 ## Testing 
-* `rspec spec/`
+* `rspec spec/`

data/lib/xero-ruby.rb

@@ -1,5 +1,5 @@
 =begin
-#Accounting API
+#Xero Accounting API
 
 #No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
@@ -10,6 +10,8 @@ OpenAPI Generator version: 4.3.1
 =end
 
 # Common files
+require 'xero-ruby/string_serialization'
+require 'xero-ruby/where'
 require 'xero-ruby/api_client'
 require 'xero-ruby/api_error'
 require 'xero-ruby/version'
@@ -285,7 +287,6 @@ require 'xero-ruby/models/payroll_au/timesheets'
 require 'xero-ruby/models/payroll_au/validation_error'
 require 'xero-ruby/models/files/association'
 require 'xero-ruby/models/files/file_object'
-require 'xero-ruby/models/files/file_response204'
 require 'xero-ruby/models/files/files'
 require 'xero-ruby/models/files/folder'
 require 'xero-ruby/models/files/folders'
@@ -349,6 +350,7 @@ require 'xero-ruby/models/accounting/bill'
 require 'xero-ruby/models/accounting/branding_theme'
 require 'xero-ruby/models/accounting/branding_themes'
 require 'xero-ruby/models/accounting/cis_org_setting'
+require 'xero-ruby/models/accounting/cis_org_settings'
 require 'xero-ruby/models/accounting/cis_setting'
 require 'xero-ruby/models/accounting/cis_settings'
 require 'xero-ruby/models/accounting/contact'

data/lib/xero-ruby/api/accounting_api.rb

@@ -1,5 +1,5 @@
 =begin
-#Accounting API
+#Xero Accounting API
 
 #No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
@@ -16,7 +16,7 @@ module XeroRuby
     def initialize(api_client = ApiClient.new)
       @api_client = api_client
     end
-    # Allows you to create a new chart of accounts
+    # Creates a new chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account [Account] Account object in body of request
     # @param [Hash] opts the optional parameters
@@ -26,7 +26,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a new chart of accounts
+    # Creates a new chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account [Account] Account object in body of request
     # @param [Hash] opts the optional parameters
@@ -92,7 +92,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachment on Account
+    # Creates an attachment on a specific account
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param file_name [String] Name of the attachment
@@ -104,7 +104,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachment on Account
+    # Creates an attachment on a specific account
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param file_name [String] Name of the attachment
@@ -180,7 +180,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create an Attachment on BankTransaction by Filename
+    # Creates an attachment for a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -192,7 +192,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create an Attachment on BankTransaction by Filename
+    # Creates an attachment for a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -268,7 +268,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create history record for a bank transactions
+    # Creates a history record for a specific bank transactions
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -279,7 +279,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create history record for a bank transactions
+    # Creates a history record for a specific bank transactions
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -350,7 +350,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create one or more spend or receive money transaction
+    # Creates one or more spent or received money transaction
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transactions [BankTransactions] BankTransactions with an array of BankTransaction objects in body of request
     # @param [Hash] opts the optional parameters
@@ -362,7 +362,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create one or more spend or receive money transaction
+    # Creates one or more spent or received money transaction
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transactions [BankTransactions] BankTransactions with an array of BankTransaction objects in body of request
     # @param [Hash] opts the optional parameters
@@ -432,7 +432,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a bank transfers
+    # Creates a bank transfer
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfers [BankTransfers] BankTransfers with array of BankTransfer objects in request body
     # @param [Hash] opts the optional parameters
@@ -442,7 +442,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a bank transfers
+    # Creates a bank transfer
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfers [BankTransfers] BankTransfers with array of BankTransfer objects in request body
     # @param [Hash] opts the optional parameters
@@ -594,7 +594,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create history record for a bank transfers
+    # Creates a history record for a specific bank transfer
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -605,7 +605,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create history record for a bank transfers
+    # Creates a history record for a specific bank transfer
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -676,7 +676,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Create one or many BatchPayments for invoices
+    # Creates one or many batch payments for invoices
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param batch_payments [BatchPayments] BatchPayments with an array of Payments in body of request
     # @param [Hash] opts the optional parameters
@@ -687,7 +687,7 @@ module XeroRuby
       data
     end
 
-    # Create one or many BatchPayments for invoices
+    # Creates one or many batch payments for invoices
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param batch_payments [BatchPayments] BatchPayments with an array of Payments in body of request
     # @param [Hash] opts the optional parameters
@@ -755,7 +755,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a history record for a Batch Payment
+    # Creates a history record for a specific batch payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param batch_payment_id [String] Unique identifier for BatchPayment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -766,7 +766,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a history record for a Batch Payment
+    # Creates a history record for a specific batch payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param batch_payment_id [String] Unique identifier for BatchPayment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -837,7 +837,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allow for the creation of new custom payment service for specified Branding Theme
+    # Creates a new custom payment service for a specific branding theme
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param branding_theme_id [String] Unique identifier for a Branding Theme
     # @param payment_service [PaymentService] PaymentService object in body of request
@@ -848,7 +848,7 @@ module XeroRuby
       data
     end
 
-    # Allow for the creation of new custom payment service for specified Branding Theme
+    # Creates a new custom payment service for a specific branding theme
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param branding_theme_id [String] Unique identifier for a Branding Theme
     # @param payment_service [PaymentService] PaymentService object in body of request
@@ -1005,7 +1005,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a contact group
+    # Creates a contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_groups [ContactGroups] ContactGroups with an array of names in request body
     # @param [Hash] opts the optional parameters
@@ -1015,7 +1015,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a contact group
+    # Creates a contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_groups [ContactGroups] ContactGroups with an array of names in request body
     # @param [Hash] opts the optional parameters
@@ -1081,10 +1081,10 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to add Contacts to a Contact Group
+    # Creates contacts to a specific contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
-    # @param contacts [Contacts] Contacts with array of contacts specifiying the ContactID to be added to ContactGroup in body of request
+    # @param contacts [Contacts] Contacts with array of contacts specifying the ContactID to be added to ContactGroup in body of request
     # @param [Hash] opts the optional parameters
     # @return [Contacts]
     def create_contact_group_contacts(xero_tenant_id, contact_group_id, contacts, opts = {})
@@ -1092,10 +1092,10 @@ module XeroRuby
       data
     end
 
-    # Allows you to add Contacts to a Contact Group
+    # Creates contacts to a specific contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
-    # @param contacts [Contacts] Contacts with array of contacts specifiying the ContactID to be added to ContactGroup in body of request
+    # @param contacts [Contacts] Contacts with array of contacts specifying the ContactID to be added to ContactGroup in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Contacts, Integer, Hash)>] Contacts data, response status code and response headers
     def create_contact_group_contacts_with_http_info(xero_tenant_id, contact_group_id, contacts, opts = {})
@@ -1163,7 +1163,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an Contact
+    # Creates a new history record for a specific contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -1174,7 +1174,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an Contact
+    # Creates a new history record for a specific contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -1245,7 +1245,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a multiple contacts (bulk) in a Xero organisation
+    # Creates multiple contacts (bulk) in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contacts [Contacts] Contacts with an array of Contact objects to create in body of request
     # @param [Hash] opts the optional parameters
@@ -1256,7 +1256,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a multiple contacts (bulk) in a Xero organisation
+    # Creates multiple contacts (bulk) in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contacts [Contacts] Contacts with an array of Contact objects to create in body of request
     # @param [Hash] opts the optional parameters
@@ -1324,7 +1324,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Allocation on CreditNote
+    # Creates allocation for a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param allocations [Allocations] Allocations with array of Allocation object in body of request.
@@ -1336,7 +1336,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Allocation on CreditNote
+    # Creates allocation for a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param allocations [Allocations] Allocations with array of Allocation object in body of request.
@@ -1409,7 +1409,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachments on CreditNote by file name
+    # Creates an attachment for a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -1422,7 +1422,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachments on CreditNote by file name
+    # Creates an attachment for a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -1500,7 +1500,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an CreditNote
+    # Retrieves history records of a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -1511,7 +1511,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an CreditNote
+    # Retrieves history records of a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -1582,7 +1582,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a credit note
+    # Creates a new credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_notes [CreditNotes] Credit Notes with array of CreditNote object in body of request
     # @param [Hash] opts the optional parameters
@@ -1594,7 +1594,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a credit note
+    # Creates a new credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_notes [CreditNotes] Credit Notes with array of CreditNote object in body of request
     # @param [Hash] opts the optional parameters
@@ -1664,9 +1664,9 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a new currency for an org
+    # Create a new currency for a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
-    # @param currency [Currency] Currency obejct in the body of request
+    # @param currency [Currency] Currency object in the body of request
     # @param [Hash] opts the optional parameters
     # @return [Currencies]
     def create_currency(xero_tenant_id, currency, opts = {})
@@ -1674,9 +1674,9 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a new currency for an org
+    # Create a new currency for a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
-    # @param currency [Currency] Currency obejct in the body of request
+    # @param currency [Currency] Currency object in the body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Currencies, Integer, Hash)>] Currencies data, response status code and response headers
     def create_currency_with_http_info(xero_tenant_id, currency, opts = {})
@@ -1740,7 +1740,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create new employees used in Xero payrun
+    # Creates new employees used in Xero payrun
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param employees [Employees] Employees with array of Employee object in body of request
     # @param [Hash] opts the optional parameters
@@ -1751,7 +1751,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create new employees used in Xero payrun
+    # Creates new employees used in Xero payrun
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param employees [Employees] Employees with array of Employee object in body of request
     # @param [Hash] opts the optional parameters
@@ -1819,7 +1819,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a history records of an ExpenseClaim
+    # Creates a history record for a specific expense claim
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -1830,7 +1830,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a history records of an ExpenseClaim
+    # Creates a history record for a specific expense claim
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -1901,7 +1901,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve expense claims
+    # Creates expense claims
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claims [ExpenseClaims] ExpenseClaims with array of ExpenseClaim object in body of request
     # @param [Hash] opts the optional parameters
@@ -1911,7 +1911,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve expense claims
+    # Creates expense claims
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claims [ExpenseClaims] ExpenseClaims with array of ExpenseClaim object in body of request
     # @param [Hash] opts the optional parameters
@@ -1977,7 +1977,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create an Attachment on invoices or purchase bills by it's filename
+    # Creates an attachment for a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -1990,7 +1990,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create an Attachment on invoices or purchase bills by it&#39;s filename
+    # Creates an attachment for a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -2068,7 +2068,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an invoice
+    # Creates a history record for a specific invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2079,7 +2079,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an invoice
+    # Creates a history record for a specific invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2150,7 +2150,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create one or more sales invoices or purchase bills
+    # Creates one or more sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoices [Invoices] Invoices with an array of invoice objects in body of request
     # @param [Hash] opts the optional parameters
@@ -2162,7 +2162,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create one or more sales invoices or purchase bills
+    # Creates one or more sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoices [Invoices] Invoices with an array of invoice objects in body of request
     # @param [Hash] opts the optional parameters
@@ -2232,7 +2232,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a history record for items
+    # Creates a history record for a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2243,7 +2243,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a history record for items
+    # Creates a history record for a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2314,7 +2314,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create one or more items
+    # Creates one or more items
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param items [Items] Items with an array of Item objects in body of request
     # @param [Hash] opts the optional parameters
@@ -2326,7 +2326,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create one or more items
+    # Creates one or more items
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param items [Items] Items with an array of Item objects in body of request
     # @param [Hash] opts the optional parameters
@@ -2396,7 +2396,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create linked transactions (billable expenses)
+    # Creates linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction [LinkedTransaction] LinkedTransaction object in body of request
     # @param [Hash] opts the optional parameters
@@ -2406,7 +2406,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create linked transactions (billable expenses)
+    # Creates linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction [LinkedTransaction] LinkedTransaction object in body of request
     # @param [Hash] opts the optional parameters
@@ -2472,7 +2472,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a specified Attachment on ManualJournal by file name
+    # Creates a specific attachment for a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -2484,7 +2484,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a specified Attachment on ManualJournal by file name
+    # Creates a specific attachment for a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -2560,7 +2560,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create history record for a manual journal
+    # Creates a history record for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2571,7 +2571,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create history record for a manual journal
+    # Creates a history record for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2642,7 +2642,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create one or more manual journals
+    # Creates one or more manual journals
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journals [ManualJournals] ManualJournals array with ManualJournal object in body of request
     # @param [Hash] opts the optional parameters
@@ -2653,7 +2653,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create one or more manual journals
+    # Creates one or more manual journals
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journals [ManualJournals] ManualJournals array with ManualJournal object in body of request
     # @param [Hash] opts the optional parameters
@@ -2721,7 +2721,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a single allocation for an overpayment
+    # Creates a single allocation for a specific overpayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param allocations [Allocations] Allocations array with Allocation object in body of request
@@ -2733,7 +2733,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a single allocation for an overpayment
+    # Creates a single allocation for a specific overpayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param allocations [Allocations] Allocations array with Allocation object in body of request
@@ -2806,7 +2806,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create history records of an Overpayment
+    # Creates a history record for a specific overpayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2817,7 +2817,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create history records of an Overpayment
+    # Creates a history record for a specific overpayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2888,7 +2888,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a single payment for invoices or credit notes
+    # Creates a single payment for invoice or credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment [Payment] Request body with a single Payment object
     # @param [Hash] opts the optional parameters
@@ -2898,7 +2898,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a single payment for invoices or credit notes
+    # Creates a single payment for invoice or credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment [Payment] Request body with a single Payment object
     # @param [Hash] opts the optional parameters
@@ -2964,7 +2964,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a history record for a payment
+    # Creates a history record for a specific payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2975,7 +2975,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a history record for a payment
+    # Creates a history record for a specific payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3046,7 +3046,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create payment services
+    # Creates a payment service
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_services [PaymentServices] PaymentServices array with PaymentService object in body of request
     # @param [Hash] opts the optional parameters
@@ -3056,7 +3056,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create payment services
+    # Creates a payment service
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_services [PaymentServices] PaymentServices array with PaymentService object in body of request
     # @param [Hash] opts the optional parameters
@@ -3122,7 +3122,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create multiple payments for invoices or credit notes
+    # Creates multiple payments for invoices or credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payments [Payments] Payments array with Payment object in body of request
     # @param [Hash] opts the optional parameters
@@ -3133,7 +3133,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create multiple payments for invoices or credit notes
+    # Creates multiple payments for invoices or credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payments [Payments] Payments array with Payment object in body of request
     # @param [Hash] opts the optional parameters
@@ -3286,7 +3286,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a history record for an Prepayment
+    # Creates a history record for a specific prepayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param prepayment_id [String] Unique identifier for a PrePayment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3297,7 +3297,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a history record for an Prepayment
+    # Creates a history record for a specific prepayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param prepayment_id [String] Unique identifier for a PrePayment
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3368,7 +3368,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachment on Purchase Order
+    # Creates attachment for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -3380,7 +3380,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachment on Purchase Order
+    # Creates attachment for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -3456,7 +3456,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create HistoryRecord for purchase orders
+    # Creates a history record for a specific purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3467,7 +3467,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create HistoryRecord for purchase orders
+    # Creates a history record for a specific purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3538,7 +3538,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create one or more purchase orders
+    # Creates one or more purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_orders [PurchaseOrders] PurchaseOrders with an array of PurchaseOrder object in body of request
     # @param [Hash] opts the optional parameters
@@ -3549,7 +3549,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create one or more purchase orders
+    # Creates one or more purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_orders [PurchaseOrders] PurchaseOrders with an array of PurchaseOrder object in body of request
     # @param [Hash] opts the optional parameters
@@ -3617,7 +3617,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachment on Quote
+    # Creates attachment for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -3629,7 +3629,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachment on Quote
+    # Creates attachment for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -3705,7 +3705,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an quote
+    # Creates a history record for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3716,7 +3716,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an quote
+    # Creates a history record for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3787,7 +3787,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create one or more quotes
+    # Create one or more quotes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quotes [Quotes] Quotes with an array of Quote object in body of request
     # @param [Hash] opts the optional parameters
@@ -3798,7 +3798,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create one or more quotes
+    # Create one or more quotes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quotes [Quotes] Quotes with an array of Quote object in body of request
     # @param [Hash] opts the optional parameters
@@ -3866,7 +3866,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create draft expense claim receipts for any user
+    # Creates draft expense claim receipts for any user
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipts [Receipts] Receipts with an array of Receipt object in body of request
     # @param [Hash] opts the optional parameters
@@ -3877,7 +3877,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create draft expense claim receipts for any user
+    # Creates draft expense claim receipts for any user
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipts [Receipts] Receipts with an array of Receipt object in body of request
     # @param [Hash] opts the optional parameters
@@ -3945,7 +3945,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachment on expense claim receipts by file name
+    # Creates an attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -3957,7 +3957,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachment on expense claim receipts by file name
+    # Creates an attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -4033,7 +4033,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an Receipt
+    # Creates a history record for a specific receipt
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -4044,7 +4044,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an Receipt
+    # Creates a history record for a specific receipt
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -4115,7 +4115,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create attachment on repeating invoices by file name
+    # Creates an attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -4127,7 +4127,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create attachment on repeating invoices by file name
+    # Creates an attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -4203,7 +4203,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create history for a repeating invoice
+    # Creates a  history record for a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -4214,7 +4214,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create history for a repeating invoice
+    # Creates a  history record for a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -4285,7 +4285,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create one or more Tax Rates
+    # Creates one or more tax rates
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tax_rates [TaxRates] TaxRates array with TaxRate object in body of request
     # @param [Hash] opts the optional parameters
@@ -4295,7 +4295,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create one or more Tax Rates
+    # Creates one or more tax rates
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tax_rates [TaxRates] TaxRates array with TaxRate object in body of request
     # @param [Hash] opts the optional parameters
@@ -4361,7 +4361,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create tracking categories
+    # Create tracking categories
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category [TrackingCategory] TrackingCategory object in body of request
     # @param [Hash] opts the optional parameters
@@ -4371,7 +4371,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create tracking categories
+    # Create tracking categories
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category [TrackingCategory] TrackingCategory object in body of request
     # @param [Hash] opts the optional parameters
@@ -4437,7 +4437,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create options for a specified tracking category
+    # Creates options for a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_option [TrackingOption] TrackingOption object in body of request
@@ -4448,7 +4448,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create options for a specified tracking category
+    # Creates options for a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_option [TrackingOption] TrackingOption object in body of request
@@ -4519,7 +4519,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete a chart of accounts
+    # Deletes a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -4529,7 +4529,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to delete a chart of accounts
+    # Deletes a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -4593,7 +4593,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete a specific Contact from a Contact Group
+    # Deletes a specific contact from a contact group using a unique contact Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param contact_id [String] Unique identifier for a Contact
@@ -4604,7 +4604,7 @@ module XeroRuby
       nil
     end
 
-    # Allows you to delete a specific Contact from a Contact Group
+    # Deletes a specific contact from a contact group using a unique contact Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param contact_id [String] Unique identifier for a Contact
@@ -4673,7 +4673,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete  all Contacts from a Contact Group
+    # Deletes all contacts from a specific contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param [Hash] opts the optional parameters
@@ -4683,7 +4683,7 @@ module XeroRuby
       nil
     end
 
-    # Allows you to delete  all Contacts from a Contact Group
+    # Deletes all contacts from a specific contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param [Hash] opts the optional parameters
@@ -4745,7 +4745,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete a specified item
+    # Deletes a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param [Hash] opts the optional parameters
@@ -4755,7 +4755,7 @@ module XeroRuby
       nil
     end
 
-    # Allows you to delete a specified item
+    # Deletes a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param [Hash] opts the optional parameters
@@ -4819,7 +4819,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete a specified linked transactions (billable expenses)
+    # Deletes a specific linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction_id [String] Unique identifier for a LinkedTransaction
     # @param [Hash] opts the optional parameters
@@ -4829,7 +4829,7 @@ module XeroRuby
       nil
     end
 
-    # Allows you to delete a specified linked transactions (billable expenses)
+    # Deletes a specific linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction_id [String] Unique identifier for a LinkedTransaction
     # @param [Hash] opts the optional parameters
@@ -4893,7 +4893,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified payment for invoices and credit notes
+    # Updates a specific payment for invoices and credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param payment_delete [PaymentDelete] 
@@ -4904,7 +4904,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified payment for invoices and credit notes
+    # Updates a specific payment for invoices and credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param payment_delete [PaymentDelete] 
@@ -4975,7 +4975,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete tracking categories
+    # Deletes a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param [Hash] opts the optional parameters
@@ -4985,7 +4985,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to delete tracking categories
+    # Deletes a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param [Hash] opts the optional parameters
@@ -5049,7 +5049,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete a specified option for a specified tracking category
+    # Deletes a specific option for a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_option_id [String] Unique identifier for a Tracking Option
@@ -5060,7 +5060,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to delete a specified option for a specified tracking category
+    # Deletes a specific option for a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_option_id [String] Unique identifier for a Tracking Option
@@ -5129,7 +5129,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to email a copy of invoice to related Contact
+    # Sends a copy of a specific invoice to related contact via email
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param request_empty [RequestEmpty] 
@@ -5140,7 +5140,7 @@ module XeroRuby
       nil
     end
 
-    # Allows you to email a copy of invoice to related Contact
+    # Sends a copy of a specific invoice to related contact via email
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param request_empty [RequestEmpty] 
@@ -5211,7 +5211,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a single chart of accounts
+    # Retrieves a single chart of accounts by using a unique account Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -5221,7 +5221,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a single chart of accounts
+    # Retrieves a single chart of accounts by using a unique account Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -5285,7 +5285,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment on Account by Filename
+    # Retrieves an attachment for a specific account by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param file_name [String] Name of the attachment
@@ -5297,7 +5297,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment on Account by Filename
+    # Retrieves an attachment for a specific account by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param file_name [String] Name of the attachment
@@ -5372,7 +5372,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specific Attachment on Account
+    # Retrieves a specific attachment from a specific account using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -5384,7 +5384,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specific Attachment on Account
+    # Retrieves a specific attachment from a specific account using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -5459,7 +5459,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments for accounts
+    # Retrieves attachments for a specific accounts by using a unique account Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param [Hash] opts the optional parameters
@@ -5469,7 +5469,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments for accounts
+    # Retrieves attachments for a specific accounts by using a unique account Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param [Hash] opts the optional parameters
@@ -5533,7 +5533,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve the full chart of accounts
+    # Retrieves the full chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -5545,7 +5545,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve the full chart of accounts
+    # Retrieves the full chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -5610,7 +5610,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a single spend or receive money transaction
+    # Retrieves a single spent or received money transaction by using a unique bank transaction Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param [Hash] opts the optional parameters
@@ -5621,7 +5621,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a single spend or receive money transaction
+    # Retrieves a single spent or received money transaction by using a unique bank transaction Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param [Hash] opts the optional parameters
@@ -5687,7 +5687,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on BankTransaction by Filename
+    # Retrieves a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -5699,7 +5699,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on BankTransaction by Filename
+    # Retrieves a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -5774,7 +5774,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on a specific BankTransaction
+    # Retrieves specific attachments from a specific BankTransaction using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param attachment_id [String] Xero generated unique identifier for an attachment
@@ -5786,7 +5786,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on a specific BankTransaction
+    # Retrieves specific attachments from a specific BankTransaction using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param attachment_id [String] Xero generated unique identifier for an attachment
@@ -5861,7 +5861,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any attachments to bank transactions
+    # Retrieves any attachments from a specific bank transactions
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param [Hash] opts the optional parameters
@@ -5871,7 +5871,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any attachments to bank transactions
+    # Retrieves any attachments from a specific bank transactions
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param [Hash] opts the optional parameters
@@ -5935,7 +5935,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any spend or receive money transactions
+    # Retrieves any spent or received money transactions
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -5949,7 +5949,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any spend or receive money transactions
+    # Retrieves any spent or received money transactions
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -6018,7 +6018,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history from a bank transactions
+    # Retrieves history from a specific bank transaction using a unique bank transaction Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param [Hash] opts the optional parameters
@@ -6028,7 +6028,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history from a bank transactions
+    # Retrieves history from a specific bank transaction using a unique bank transaction Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param [Hash] opts the optional parameters
@@ -6092,7 +6092,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any bank transfers
+    # Retrieves specific bank transfers by using a unique bank transfer Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param [Hash] opts the optional parameters
@@ -6102,7 +6102,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any bank transfers
+    # Retrieves specific bank transfers by using a unique bank transfer Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param [Hash] opts the optional parameters
@@ -6166,7 +6166,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on BankTransfer by file name
+    # Retrieves a specific attachment on a specific bank transfer by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param file_name [String] The name of the file being attached to a Bank Transfer
@@ -6178,7 +6178,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on BankTransfer by file name
+    # Retrieves a specific attachment on a specific bank transfer by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param file_name [String] The name of the file being attached to a Bank Transfer
@@ -6253,7 +6253,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on BankTransfer
+    # Retrieves a specific attachment from a specific bank transfer using a unique attachment ID
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param attachment_id [String] Xero generated unique identifier for an Attachment to a bank transfer
@@ -6265,7 +6265,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on BankTransfer
+    # Retrieves a specific attachment from a specific bank transfer using a unique attachment ID
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param attachment_id [String] Xero generated unique identifier for an Attachment to a bank transfer
@@ -6340,7 +6340,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments from  bank transfers
+    # Retrieves attachments from a specific bank transfer
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param [Hash] opts the optional parameters
@@ -6350,7 +6350,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments from  bank transfers
+    # Retrieves attachments from a specific bank transfer
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param [Hash] opts the optional parameters
@@ -6414,7 +6414,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history from a bank transfers
+    # Retrieves history from a specific bank transfer using a unique bank transfer Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param [Hash] opts the optional parameters
@@ -6424,7 +6424,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history from a bank transfers
+    # Retrieves history from a specific bank transfer using a unique bank transfer Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param [Hash] opts the optional parameters
@@ -6488,7 +6488,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve all bank transfers
+    # Retrieves all bank transfers
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -6500,7 +6500,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve all bank transfers
+    # Retrieves all bank transfers
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -6565,7 +6565,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history from a Batch Payment
+    # Retrieves history from a specific batch payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param batch_payment_id [String] Unique identifier for BatchPayment
     # @param [Hash] opts the optional parameters
@@ -6575,7 +6575,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history from a Batch Payment
+    # Retrieves history from a specific batch payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param batch_payment_id [String] Unique identifier for BatchPayment
     # @param [Hash] opts the optional parameters
@@ -6639,7 +6639,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Retrieve either one or many BatchPayments for invoices
+    # Retrieves either one or many batch payments for invoices
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -6651,7 +6651,7 @@ module XeroRuby
       data
     end
 
-    # Retrieve either one or many BatchPayments for invoices
+    # Retrieves either one or many batch payments for invoices
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -6716,7 +6716,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specific BrandingThemes
+    # Retrieves a specific branding theme using a unique branding theme Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param branding_theme_id [String] Unique identifier for a Branding Theme
     # @param [Hash] opts the optional parameters
@@ -6726,7 +6726,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specific BrandingThemes
+    # Retrieves a specific branding theme using a unique branding theme Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param branding_theme_id [String] Unique identifier for a Branding Theme
     # @param [Hash] opts the optional parameters
@@ -6790,7 +6790,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve the Payment services for a Branding Theme
+    # Retrieves the payment services for a specific branding theme
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param branding_theme_id [String] Unique identifier for a Branding Theme
     # @param [Hash] opts the optional parameters
@@ -6800,7 +6800,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve the Payment services for a Branding Theme
+    # Retrieves the payment services for a specific branding theme
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param branding_theme_id [String] Unique identifier for a Branding Theme
     # @param [Hash] opts the optional parameters
@@ -6864,7 +6864,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve all the BrandingThemes
+    # Retrieves all the branding themes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [BrandingThemes]
@@ -6873,7 +6873,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve all the BrandingThemes
+    # Retrieves all the branding themes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Array<(BrandingThemes, Integer, Hash)>] BrandingThemes data, response status code and response headers
@@ -6932,7 +6932,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a single contacts in a Xero organisation
+    # Retrieves a specific contacts in a Xero organisation using a unique contact Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -6942,7 +6942,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a single contacts in a Xero organisation
+    # Retrieves a specific contacts in a Xero organisation using a unique contact Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -7006,7 +7006,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on Contacts by file name
+    # Retrieves a specific attachment from a specific contact by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param file_name [String] Name for the file you are attaching
@@ -7018,7 +7018,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on Contacts by file name
+    # Retrieves a specific attachment from a specific contact by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param file_name [String] Name for the file you are attaching
@@ -7093,7 +7093,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on Contacts
+    # Retrieves a specific attachment from a specific contact using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -7105,7 +7105,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on Contacts
+    # Retrieves a specific attachment from a specific contact using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -7180,7 +7180,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve, add and update contacts in a Xero organisation
+    # Retrieves attachments for a specific contact in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -7190,7 +7190,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve, add and update contacts in a Xero organisation
+    # Retrieves attachments for a specific contact in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -7254,7 +7254,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a single contact by Contact Number in a Xero organisation
+    # Retrieves a specific contact by contact number in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_number [String] This field is read only on the Xero contact screen, used to identify contacts in external systems (max length &#x3D; 50).
     # @param [Hash] opts the optional parameters
@@ -7264,7 +7264,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a single contact by Contact Number in a Xero organisation
+    # Retrieves a specific contact by contact number in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_number [String] This field is read only on the Xero contact screen, used to identify contacts in external systems (max length &#x3D; 50).
     # @param [Hash] opts the optional parameters
@@ -7328,7 +7328,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve CISSettings for a contact in a Xero organisation
+    # Retrieves CIS settings for a specific contact in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -7338,7 +7338,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve CISSettings for a contact in a Xero organisation
+    # Retrieves CIS settings for a specific contact in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -7402,7 +7402,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a unique Contact Group by ID
+    # Retrieves a specific contact group by using a unique contact group Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param [Hash] opts the optional parameters
@@ -7412,7 +7412,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a unique Contact Group by ID
+    # Retrieves a specific contact group by using a unique contact group Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param [Hash] opts the optional parameters
@@ -7476,7 +7476,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve the ContactID and Name of all the contacts in a contact group
+    # Retrieves the contact Id and name of all the contacts in a contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -7487,7 +7487,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve the ContactID and Name of all the contacts in a contact group
+    # Retrieves the contact Id and name of all the contacts in a contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -7550,7 +7550,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an Contact
+    # Retrieves history records for a specific contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -7560,7 +7560,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an Contact
+    # Retrieves history records for a specific contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -7624,7 +7624,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve all contacts in a Xero organisation
+    # Retrieves all contacts in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -7639,7 +7639,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve all contacts in a Xero organisation
+    # Retrieves all contacts in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -7710,7 +7710,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specific credit note
+    # Retrieves a specific credit note using a unique credit note Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -7721,7 +7721,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specific credit note
+    # Retrieves a specific credit note using a unique credit note Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -7787,7 +7787,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Credit Note as PDF files
+    # Retrieves credit notes as PDF files
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -7797,7 +7797,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Credit Note as PDF files
+    # Retrieves credit notes as PDF files
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -7861,7 +7861,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on CreditNote by file name
+    # Retrieves a specific attachment on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -7873,7 +7873,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on CreditNote by file name
+    # Retrieves a specific attachment on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -7948,7 +7948,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on CreditNote
+    # Retrieves a specific attachment from a specific credit note using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -7960,7 +7960,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on CreditNote
+    # Retrieves a specific attachment from a specific credit note using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -8035,7 +8035,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments for credit notes
+    # Retrieves attachments for a specific credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -8045,7 +8045,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments for credit notes
+    # Retrieves attachments for a specific credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -8109,7 +8109,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an CreditNote
+    # Retrieves history records of a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -8119,7 +8119,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an CreditNote
+    # Retrieves history records of a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param [Hash] opts the optional parameters
@@ -8183,7 +8183,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any credit notes
+    # Retrieves any credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -8197,7 +8197,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any credit notes
+    # Retrieves any credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -8266,7 +8266,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve currencies for your organisation
+    # Retrieves currencies for your Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -8277,7 +8277,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve currencies for your organisation
+    # Retrieves currencies for your Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -8340,7 +8340,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specific employee used in Xero payrun
+    # Retrieves a specific employee used in Xero payrun using a unique employee Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param employee_id [String] Unique identifier for a Employee
     # @param [Hash] opts the optional parameters
@@ -8350,7 +8350,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specific employee used in Xero payrun
+    # Retrieves a specific employee used in Xero payrun using a unique employee Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param employee_id [String] Unique identifier for a Employee
     # @param [Hash] opts the optional parameters
@@ -8414,7 +8414,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve employees used in Xero payrun
+    # Retrieves employees used in Xero payrun
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -8426,7 +8426,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve employees used in Xero payrun
+    # Retrieves employees used in Xero payrun
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -8491,7 +8491,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified expense claim
+    # Retrieves a specific expense claim using a unique expense claim Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param [Hash] opts the optional parameters
@@ -8501,7 +8501,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified expense claim
+    # Retrieves a specific expense claim using a unique expense claim Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param [Hash] opts the optional parameters
@@ -8565,7 +8565,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an ExpenseClaim
+    # Retrieves history records of a specific expense claim
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param [Hash] opts the optional parameters
@@ -8575,7 +8575,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an ExpenseClaim
+    # Retrieves history records of a specific expense claim
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param [Hash] opts the optional parameters
@@ -8639,7 +8639,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve expense claims
+    # Retrieves expense claims
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -8651,7 +8651,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve expense claims
+    # Retrieves expense claims
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -8716,7 +8716,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified sales invoice or purchase bill
+    # Retrieves a specific sales invoice or purchase bill using a unique invoice Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -8727,7 +8727,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified sales invoice or purchase bill
+    # Retrieves a specific sales invoice or purchase bill using a unique invoice Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -8793,7 +8793,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve invoices or purchase bills as PDF files
+    # Retrieves invoices or purchase bills as PDF files
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -8803,7 +8803,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve invoices or purchase bills as PDF files
+    # Retrieves invoices or purchase bills as PDF files
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -8867,7 +8867,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment on invoices or purchase bills by it's filename
+    # Retrieves an attachment from a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -8879,7 +8879,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment on invoices or purchase bills by it&#39;s filename
+    # Retrieves an attachment from a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -8954,7 +8954,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified Attachment on invoices or purchase bills by it's ID
+    # Retrieves a specific attachment from a specific invoices or purchase bills by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param attachment_id [String] Unique identifier for an Attachment
@@ -8966,7 +8966,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified Attachment on invoices or purchase bills by it&#39;s ID
+    # Retrieves a specific attachment from a specific invoices or purchase bills by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param attachment_id [String] Unique identifier for an Attachment
@@ -9041,7 +9041,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on invoices or purchase bills
+    # Retrieves attachments for a specific invoice or purchase bill
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -9051,7 +9051,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on invoices or purchase bills
+    # Retrieves attachments for a specific invoice or purchase bill
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -9115,7 +9115,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an invoice
+    # Retrieves history records for a specific invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -9125,7 +9125,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an invoice
+    # Retrieves history records for a specific invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -9189,7 +9189,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve invoice reminder settings
+    # Retrieves invoice reminder settings
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [InvoiceReminders]
@@ -9198,7 +9198,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve invoice reminder settings
+    # Retrieves invoice reminder settings
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Array<(InvoiceReminders, Integer, Hash)>] InvoiceReminders data, response status code and response headers
@@ -9257,7 +9257,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any sales invoices or purchase bills
+    # Retrieves sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -9277,7 +9277,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any sales invoices or purchase bills
+    # Retrieves sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -9358,7 +9358,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified item
+    # Retrieves a specific item using a unique item Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param [Hash] opts the optional parameters
@@ -9369,7 +9369,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified item
+    # Retrieves a specific item using a unique item Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param [Hash] opts the optional parameters
@@ -9435,7 +9435,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history for items
+    # Retrieves history for a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param [Hash] opts the optional parameters
@@ -9445,7 +9445,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history for items
+    # Retrieves history for a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param [Hash] opts the optional parameters
@@ -9509,7 +9509,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any items
+    # Retrieves items
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -9522,7 +9522,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any items
+    # Retrieves items
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -9589,7 +9589,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified journals.
+    # Retrieves a specific journal using a unique journal Id.
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param journal_id [String] Unique identifier for a Journal
     # @param [Hash] opts the optional parameters
@@ -9599,7 +9599,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified journals.
+    # Retrieves a specific journal using a unique journal Id.
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param journal_id [String] Unique identifier for a Journal
     # @param [Hash] opts the optional parameters
@@ -9663,7 +9663,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any journals.
+    # Retrieves journals
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -9675,7 +9675,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any journals.
+    # Retrieves journals
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -9740,7 +9740,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified linked transactions (billable expenses)
+    # Retrieves a specific linked transaction (billable expenses) using a unique linked transaction Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction_id [String] Unique identifier for a LinkedTransaction
     # @param [Hash] opts the optional parameters
@@ -9750,7 +9750,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified linked transactions (billable expenses)
+    # Retrieves a specific linked transaction (billable expenses) using a unique linked transaction Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction_id [String] Unique identifier for a LinkedTransaction
     # @param [Hash] opts the optional parameters
@@ -9814,14 +9814,14 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Retrieve linked transactions (billable expenses)
+    # Retrieves linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :page Up to 100 linked transactions will be returned in a single API call. Use the page parameter to specify the page to be returned e.g. page&#x3D;1.
     # @option opts [String] :linked_transaction_id The Xero identifier for an Linked Transaction
     # @option opts [String] :source_transaction_id Filter by the SourceTransactionID. Get the linked transactions created from a particular ACCPAY invoice
     # @option opts [String] :contact_id Filter by the ContactID. Get all the linked transactions that have been assigned to a particular customer.
-    # @option opts [String] :status Filter by the combination of ContactID and Status. Get  the linked transactions associaed to a  customer and with a status
+    # @option opts [String] :status Filter by the combination of ContactID and Status. Get  the linked transactions associated to a  customer and with a status
     # @option opts [String] :target_transaction_id Filter by the TargetTransactionID. Get all the linked transactions allocated to a particular ACCREC invoice
     # @return [LinkedTransactions]
     def get_linked_transactions(xero_tenant_id, opts = {})
@@ -9829,14 +9829,14 @@ module XeroRuby
       data
     end
 
-    # Retrieve linked transactions (billable expenses)
+    # Retrieves linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :page Up to 100 linked transactions will be returned in a single API call. Use the page parameter to specify the page to be returned e.g. page&#x3D;1.
     # @option opts [String] :linked_transaction_id The Xero identifier for an Linked Transaction
     # @option opts [String] :source_transaction_id Filter by the SourceTransactionID. Get the linked transactions created from a particular ACCPAY invoice
     # @option opts [String] :contact_id Filter by the ContactID. Get all the linked transactions that have been assigned to a particular customer.
-    # @option opts [String] :status Filter by the combination of ContactID and Status. Get  the linked transactions associaed to a  customer and with a status
+    # @option opts [String] :status Filter by the combination of ContactID and Status. Get  the linked transactions associated to a  customer and with a status
     # @option opts [String] :target_transaction_id Filter by the TargetTransactionID. Get all the linked transactions allocated to a particular ACCREC invoice
     # @return [Array<(LinkedTransactions, Integer, Hash)>] LinkedTransactions data, response status code and response headers
     def get_linked_transactions_with_http_info(xero_tenant_id, opts = {})
@@ -9900,7 +9900,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified manual journals
+    # Retrieves a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param [Hash] opts the optional parameters
@@ -9910,7 +9910,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified manual journals
+    # Retrieves a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param [Hash] opts the optional parameters
@@ -9974,7 +9974,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournal by file name
+    # Retrieves a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -9986,7 +9986,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournal by file name
+    # Retrieves a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -10061,7 +10061,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournals
+    # Allows you to retrieve a specific attachment from a specific manual journal using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -10073,7 +10073,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournals
+    # Allows you to retrieve a specific attachment from a specific manual journal using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -10148,7 +10148,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment for manual journals
+    # Retrieves attachment for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param [Hash] opts the optional parameters
@@ -10158,7 +10158,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment for manual journals
+    # Retrieves attachment for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param [Hash] opts the optional parameters
@@ -10222,7 +10222,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any manual journals
+    # Retrieves manual journals
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -10235,7 +10235,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any manual journals
+    # Retrieves manual journals
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -10302,7 +10302,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history from a manual journal
+    # Retrieves history for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param [Hash] opts the optional parameters
@@ -10312,7 +10312,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history from a manual journal
+    # Retrieves history for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param [Hash] opts the optional parameters
@@ -10376,7 +10376,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a URL to an online invoice
+    # Retrieves a URL to an online invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -10386,7 +10386,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a URL to an online invoice
+    # Retrieves a URL to an online invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param [Hash] opts the optional parameters
@@ -10450,7 +10450,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Retrieve a list of the key actions your app has permission to perform in the connected organisation.
+    # Retrieves a list of the key actions your app has permission to perform in the connected Xero organisation.
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Actions]
@@ -10459,7 +10459,7 @@ module XeroRuby
       data
     end
 
-    # Retrieve a list of the key actions your app has permission to perform in the connected organisation.
+    # Retrieves a list of the key actions your app has permission to perform in the connected Xero organisation.
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Array<(Actions, Integer, Hash)>] Actions data, response status code and response headers
@@ -10518,21 +10518,21 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you To verify if an organisation is using contruction industry scheme, you can retrieve the CIS settings for the organistaion.
+    # Retrieves the CIS settings for the Xero organistaion.
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param organisation_id [String] The unique Xero identifier for an organisation
     # @param [Hash] opts the optional parameters
-    # @return [CISOrgSetting]
+    # @return [CISOrgSettings]
     def get_organisation_cis_settings(xero_tenant_id, organisation_id, opts = {})
       data, _status_code, _headers = get_organisation_cis_settings_with_http_info(xero_tenant_id, organisation_id, opts)
       data
     end
 
-    # Allows you To verify if an organisation is using contruction industry scheme, you can retrieve the CIS settings for the organistaion.
+    # Retrieves the CIS settings for the Xero organistaion.
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param organisation_id [String] The unique Xero identifier for an organisation
     # @param [Hash] opts the optional parameters
-    # @return [Array<(CISOrgSetting, Integer, Hash)>] CISOrgSetting data, response status code and response headers
+    # @return [Array<(CISOrgSettings, Integer, Hash)>] CISOrgSettings data, response status code and response headers
     def get_organisation_cis_settings_with_http_info(xero_tenant_id, organisation_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AccountingApi.get_organisation_cis_settings ...'
@@ -10571,7 +10571,7 @@ module XeroRuby
       post_body = opts[:body] 
 
       # return_type
-      return_type = opts[:return_type] || 'CISOrgSetting' 
+      return_type = opts[:return_type] || 'CISOrgSettings' 
 
       # auth_names
       auth_names = opts[:auth_names] || ['OAuth2']
@@ -10592,7 +10592,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Organisation details
+    # Retrieves Xero organisation details
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Organisations]
@@ -10601,7 +10601,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Organisation details
+    # Retrieves Xero organisation details
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Array<(Organisations, Integer, Hash)>] Organisations data, response status code and response headers
@@ -10660,7 +10660,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified overpayments
+    # Retrieves a specific overpayment using a unique overpayment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param [Hash] opts the optional parameters
@@ -10670,7 +10670,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified overpayments
+    # Retrieves a specific overpayment using a unique overpayment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param [Hash] opts the optional parameters
@@ -10734,7 +10734,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an Overpayment
+    # Retrieves history records of a specific overpayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param [Hash] opts the optional parameters
@@ -10744,7 +10744,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an Overpayment
+    # Retrieves history records of a specific overpayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param overpayment_id [String] Unique identifier for a Overpayment
     # @param [Hash] opts the optional parameters
@@ -10808,7 +10808,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve overpayments
+    # Retrieves overpayments
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -10822,7 +10822,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve overpayments
+    # Retrieves overpayments
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -10891,7 +10891,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified payment for invoices and credit notes
+    # Retrieves a specific payment for invoices and credit notes using a unique payment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param [Hash] opts the optional parameters
@@ -10901,7 +10901,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified payment for invoices and credit notes
+    # Retrieves a specific payment for invoices and credit notes using a unique payment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param [Hash] opts the optional parameters
@@ -10965,7 +10965,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history records of a payment
+    # Retrieves history records of a specific payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param [Hash] opts the optional parameters
@@ -10975,7 +10975,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history records of a payment
+    # Retrieves history records of a specific payment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param payment_id [String] Unique identifier for a Payment
     # @param [Hash] opts the optional parameters
@@ -11039,7 +11039,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve payment services
+    # Retrieves payment services
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [PaymentServices]
@@ -11048,7 +11048,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve payment services
+    # Retrieves payment services
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Array<(PaymentServices, Integer, Hash)>] PaymentServices data, response status code and response headers
@@ -11107,7 +11107,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve payments for invoices and credit notes
+    # Retrieves payments for invoices and credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -11120,7 +11120,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve payments for invoices and credit notes
+    # Retrieves payments for invoices and credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -11261,7 +11261,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an Prepayment
+    # Retrieves history record for a specific prepayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param prepayment_id [String] Unique identifier for a PrePayment
     # @param [Hash] opts the optional parameters
@@ -11271,7 +11271,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an Prepayment
+    # Retrieves history record for a specific prepayment
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param prepayment_id [String] Unique identifier for a PrePayment
     # @param [Hash] opts the optional parameters
@@ -11335,7 +11335,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve prepayments
+    # Retrieves prepayments
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -11349,7 +11349,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve prepayments
+    # Retrieves prepayments
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -11418,7 +11418,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified purchase orders
+    # Retrieves a specific purchase order using a unique purchase order Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11428,7 +11428,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified purchase orders
+    # Retrieves a specific purchase order using a unique purchase order Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11492,7 +11492,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve purchase orders as PDF files
+    # Retrieves specific purchase order as PDF files using a unique purchase order Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
@@ -11502,7 +11502,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve purchase orders as PDF files
+    # Retrieves specific purchase order as PDF files using a unique purchase order Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
@@ -11566,7 +11566,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment on a Purchase Order by Filename
+    # Retrieves a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -11578,7 +11578,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment on a Purchase Order by Filename
+    # Retrieves a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -11653,7 +11653,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specific Attachment on purchase order
+    # Retrieves specific attachment for a specific purchase order using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -11665,7 +11665,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specific Attachment on purchase order
+    # Retrieves specific attachment for a specific purchase order using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -11740,7 +11740,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve attachments for purchase orders
+    # Retrieves attachments for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Orders object
     # @param [Hash] opts the optional parameters
@@ -11750,7 +11750,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve attachments for purchase orders
+    # Retrieves attachments for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Orders object
     # @param [Hash] opts the optional parameters
@@ -11814,7 +11814,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified purchase orders
+    # Retrieves a specific purchase order using purchase order number
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_number [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11824,7 +11824,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified purchase orders
+    # Retrieves a specific purchase order using purchase order number
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_number [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11888,7 +11888,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history for PurchaseOrder
+    # Retrieves history for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11898,7 +11898,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history for PurchaseOrder
+    # Retrieves history for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11962,7 +11962,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve purchase orders
+    # Retrieves purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -11977,7 +11977,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve purchase orders
+    # Retrieves purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -12052,7 +12052,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified quote
+    # Retrieves a specific quote using a unique quote Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
@@ -12062,7 +12062,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified quote
+    # Retrieves a specific quote using a unique quote Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
@@ -12126,7 +12126,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve quotes as PDF files
+    # Retrieves a specific quote as a PDF file using a unique quote Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
@@ -12136,7 +12136,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve quotes as PDF files
+    # Retrieves a specific quote as a PDF file using a unique quote Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
@@ -12200,7 +12200,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment on Quote by Filename
+    # Retrieves a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -12212,7 +12212,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment on Quote by Filename
+    # Retrieves a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -12287,7 +12287,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specific Attachment on Quote
+    # Retrieves a specific attachment from a specific quote using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -12299,7 +12299,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specific Attachment on Quote
+    # Retrieves a specific attachment from a specific quote using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -12374,7 +12374,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments for Quotes
+    # Retrieves attachments for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param [Hash] opts the optional parameters
@@ -12384,7 +12384,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments for Quotes
+    # Retrieves attachments for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param [Hash] opts the optional parameters
@@ -12448,7 +12448,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an quote
+    # Retrieves history records of a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
@@ -12458,7 +12458,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an quote
+    # Retrieves history records of a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
@@ -12522,7 +12522,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any sales quotes
+    # Retrieves sales quotes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -12541,7 +12541,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any sales quotes
+    # Retrieves sales quotes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -12620,7 +12620,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified draft expense claim receipts
+    # Retrieves a specific draft expense claim receipt by using a unique receipt Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param [Hash] opts the optional parameters
@@ -12631,7 +12631,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified draft expense claim receipts
+    # Retrieves a specific draft expense claim receipt by using a unique receipt Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param [Hash] opts the optional parameters
@@ -12697,7 +12697,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by file name
+    # Retrieves a specific attachment from a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -12709,7 +12709,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by file name
+    # Retrieves a specific attachment from a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -12784,7 +12784,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by ID
+    # Retrieves a specific attachments from a specific expense claim receipts by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -12796,7 +12796,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by ID
+    # Retrieves a specific attachments from a specific expense claim receipts by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -12871,7 +12871,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments for expense claim receipts
+    # Retrieves attachments for a specific expense claim receipt
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param [Hash] opts the optional parameters
@@ -12881,7 +12881,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments for expense claim receipts
+    # Retrieves attachments for a specific expense claim receipt
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param [Hash] opts the optional parameters
@@ -12945,7 +12945,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a history records of an Receipt
+    # Retrieves a history record for a specific receipt
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param [Hash] opts the optional parameters
@@ -12955,7 +12955,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a history records of an Receipt
+    # Retrieves a history record for a specific receipt
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param [Hash] opts the optional parameters
@@ -13019,7 +13019,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve draft expense claim receipts for any user
+    # Retrieves draft expense claim receipts for any user
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -13032,7 +13032,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve draft expense claim receipts for any user
+    # Retrieves draft expense claim receipts for any user
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -13099,7 +13099,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified repeating invoice
+    # Retrieves a specific repeating invoice by using a unique repeating invoice Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param [Hash] opts the optional parameters
@@ -13109,7 +13109,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified repeating invoice
+    # Retrieves a specific repeating invoice by using a unique repeating invoice Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param [Hash] opts the optional parameters
@@ -13173,7 +13173,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specified attachment on repeating invoices by file name
+    # Retrieves a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -13185,7 +13185,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specified attachment on repeating invoices by file name
+    # Retrieves a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -13260,7 +13260,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified Attachments on repeating invoices
+    # Retrieves a specific attachment from a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -13272,7 +13272,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified Attachments on repeating invoices
+    # Retrieves a specific attachment from a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -13347,7 +13347,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on repeating invoice
+    # Retrieves attachments from a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param [Hash] opts the optional parameters
@@ -13357,7 +13357,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on repeating invoice
+    # Retrieves attachments from a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param [Hash] opts the optional parameters
@@ -13421,7 +13421,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history for a repeating invoice
+    # Retrieves history record for a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param [Hash] opts the optional parameters
@@ -13431,7 +13431,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history for a repeating invoice
+    # Retrieves history record for a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param [Hash] opts the optional parameters
@@ -13495,7 +13495,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve any repeating invoices
+    # Retrieves repeating invoices
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -13506,7 +13506,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve any repeating invoices
+    # Retrieves repeating invoices
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -13569,7 +13569,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for AgedPayablesByContact
+    # Retrieves report for aged payables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13582,7 +13582,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for AgedPayablesByContact
+    # Retrieves report for aged payables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13653,7 +13653,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for AgedReceivablesByContact
+    # Retrieves report for aged receivables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13666,7 +13666,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for AgedReceivablesByContact
+    # Retrieves report for aged receivables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13737,7 +13737,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for BAS only valid for AU orgs
+    # Retrieves a specific report for BAS using a unique report Id (only valid for AU orgs)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param report_id [String] Unique identifier for a Report
     # @param [Hash] opts the optional parameters
@@ -13747,7 +13747,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for BAS only valid for AU orgs
+    # Retrieves a specific report for BAS using a unique report Id (only valid for AU orgs)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param report_id [String] Unique identifier for a Report
     # @param [Hash] opts the optional parameters
@@ -13811,7 +13811,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for BAS only valid for AU orgs
+    # Retrieves report for BAS (only valid for AU orgs)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [ReportWithRows]
@@ -13820,7 +13820,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for BAS only valid for AU orgs
+    # Retrieves report for BAS (only valid for AU orgs)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @return [Array<(ReportWithRows, Integer, Hash)>] ReportWithRows data, response status code and response headers
@@ -13879,7 +13879,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for BalanceSheet
+    # Retrieves report for balancesheet
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date of the Balance Sheet report
@@ -13895,7 +13895,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for BalanceSheet
+    # Retrieves report for balancesheet
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date of the Balance Sheet report
@@ -13972,7 +13972,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for BankSummary
+    # Retrieves report for bank summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the Bank Summary report e.g. 2018-03-31
@@ -13983,7 +13983,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for BankSummary
+    # Retrieves report for bank summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the Bank Summary report e.g. 2018-03-31
@@ -14046,7 +14046,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for Budget Summary
+    # Retrieves report for budget summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date for the Bank Summary report e.g. 2018-03-31
@@ -14058,7 +14058,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for Budget Summary
+    # Retrieves report for budget summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date for the Bank Summary report e.g. 2018-03-31
@@ -14123,7 +14123,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for ExecutiveSummary
+    # Retrieves report for executive summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date for the Bank Summary report e.g. 2018-03-31
@@ -14133,7 +14133,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for ExecutiveSummary
+    # Retrieves report for executive summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date for the Bank Summary report e.g. 2018-03-31
@@ -14194,7 +14194,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for ProfitAndLoss
+    # Retrieves report for profit and loss
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the ProfitAndLoss report e.g. 2018-03-31
@@ -14213,7 +14213,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for ProfitAndLoss
+    # Retrieves report for profit and loss
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the ProfitAndLoss report e.g. 2018-03-31
@@ -14296,7 +14296,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for TenNinetyNine
+    # Retrieve reports for 1099
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :report_year The year of the 1099 report
@@ -14306,7 +14306,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for TenNinetyNine
+    # Retrieve reports for 1099
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :report_year The year of the 1099 report
@@ -14367,7 +14367,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for TrialBalance
+    # Retrieves report for trial balance
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date for the Trial Balance report e.g. 2018-03-31
@@ -14378,7 +14378,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for TrialBalance
+    # Retrieves report for trial balance
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :date The date for the Trial Balance report e.g. 2018-03-31
@@ -14441,7 +14441,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Tax Rates
+    # Retrieves tax rates
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -14453,7 +14453,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Tax Rates
+    # Retrieves tax rates
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -14518,7 +14518,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve tracking categories and options
+    # Retrieves tracking categories and options
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -14530,7 +14530,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve tracking categories and options
+    # Retrieves tracking categories and options
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [String] :where Filter by an any element
@@ -14595,7 +14595,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve tracking categories and options for specified category
+    # Retrieves specific tracking categories and options using a unique tracking category Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param [Hash] opts the optional parameters
@@ -14605,7 +14605,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve tracking categories and options for specified category
+    # Retrieves specific tracking categories and options using a unique tracking category Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param [Hash] opts the optional parameters
@@ -14669,7 +14669,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified user
+    # Retrieves a specific user
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param user_id [String] Unique identifier for a User
     # @param [Hash] opts the optional parameters
@@ -14679,7 +14679,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified user
+    # Retrieves a specific user
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param user_id [String] Unique identifier for a User
     # @param [Hash] opts the optional parameters
@@ -14743,7 +14743,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve users
+    # Retrieves users
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -14755,7 +14755,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve users
+    # Retrieves users
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [DateTime] :if_modified_since Only records created or modified since this timestamp will be returned
@@ -14820,7 +14820,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to set the chart of accounts, the conversion date and conversion balances
+    # Sets the chart of accounts, the conversion date and conversion balances
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param setup [Setup] Object including an accounts array, a conversion balances array and a conversion date object in body of request
     # @param [Hash] opts the optional parameters
@@ -14830,7 +14830,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to set the chart of accounts, the conversion date and conversion balances
+    # Sets the chart of accounts, the conversion date and conversion balances
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param setup [Setup] Object including an accounts array, a conversion balances array and a conversion date object in body of request
     # @param [Hash] opts the optional parameters
@@ -14896,7 +14896,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a chart of accounts
+    # Updates a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param accounts [Accounts] Request of type Accounts array with one Account
@@ -14907,7 +14907,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a chart of accounts
+    # Updates a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param accounts [Accounts] Request of type Accounts array with one Account
@@ -14978,7 +14978,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on Account by Filename
+    # Updates attachment on a specific account by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param file_name [String] Name of the attachment
@@ -14990,7 +14990,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on Account by Filename
+    # Updates attachment on a specific account by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for Account object
     # @param file_name [String] Name of the attachment
@@ -15066,7 +15066,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a single spend or receive money transaction
+    # Updates a single spent or received money transaction
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param bank_transactions [BankTransactions] 
@@ -15078,7 +15078,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a single spend or receive money transaction
+    # Updates a single spent or received money transaction
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param bank_transactions [BankTransactions] 
@@ -15151,7 +15151,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update an Attachment on BankTransaction by Filename
+    # Updates a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -15163,7 +15163,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update an Attachment on BankTransaction by Filename
+    # Updates a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -15325,7 +15325,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update one contact in a Xero organisation
+    # Updates a specific contact in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param contacts [Contacts] an array of Contacts containing single Contact object with properties to update
@@ -15336,7 +15336,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update one contact in a Xero organisation
+    # Updates a specific contact in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param contacts [Contacts] an array of Contacts containing single Contact object with properties to update
@@ -15493,7 +15493,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a Contact Group
+    # Updates a specific contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param contact_groups [ContactGroups] an array of Contact groups with Name of specific group to update
@@ -15504,7 +15504,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a Contact Group
+    # Updates a specific contact group
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_group_id [String] Unique identifier for a Contact Group
     # @param contact_groups [ContactGroups] an array of Contact groups with Name of specific group to update
@@ -15575,7 +15575,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specific credit note
+    # Updates a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param credit_notes [CreditNotes] an array of Credit Notes containing credit note details to update
@@ -15587,7 +15587,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specific credit note
+    # Updates a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param credit_notes [CreditNotes] an array of Credit Notes containing credit note details to update
@@ -15660,7 +15660,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachments on CreditNote by file name
+    # Updates attachments on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -15672,7 +15672,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachments on CreditNote by file name
+    # Updates attachments on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -15748,7 +15748,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update specified expense claims
+    # Updates a specific expense claims
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param expense_claims [ExpenseClaims] 
@@ -15759,7 +15759,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update specified expense claims
+    # Updates a specific expense claims
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param expense_claim_id [String] Unique identifier for a ExpenseClaim
     # @param expense_claims [ExpenseClaims] 
@@ -15830,7 +15830,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified sales invoices or purchase bills
+    # Updates a specific sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param invoices [Invoices] 
@@ -15842,7 +15842,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified sales invoices or purchase bills
+    # Updates a specific sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param invoices [Invoices] 
@@ -15915,7 +15915,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on invoices or purchase bills by it's filename
+    # Updates an attachment from a specific invoices or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -15927,7 +15927,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on invoices or purchase bills by it&#39;s filename
+    # Updates an attachment from a specific invoices or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -16003,7 +16003,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified item
+    # Updates a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param items [Items] 
@@ -16015,7 +16015,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified item
+    # Updates a specific item
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param item_id [String] Unique identifier for an Item
     # @param items [Items] 
@@ -16088,7 +16088,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified linked transactions (billable expenses)
+    # Updates a specific linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction_id [String] Unique identifier for a LinkedTransaction
     # @param linked_transactions [LinkedTransactions] 
@@ -16099,7 +16099,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified linked transactions (billable expenses)
+    # Updates a specific linked transactions (billable expenses)
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param linked_transaction_id [String] Unique identifier for a LinkedTransaction
     # @param linked_transactions [LinkedTransactions] 
@@ -16170,7 +16170,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified manual journal
+    # Updates a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param manual_journals [ManualJournals] 
@@ -16181,7 +16181,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified manual journal
+    # Updates a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param manual_journals [ManualJournals] 
@@ -16252,7 +16252,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified Attachment on ManualJournal by file name
+    # Updates a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -16264,7 +16264,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified Attachment on ManualJournal by file name
+    # Updates a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -16340,7 +16340,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update or create one or more spend or receive money transaction
+    # Updates or creates one or more spent or received money transaction
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transactions [BankTransactions] 
     # @param [Hash] opts the optional parameters
@@ -16352,7 +16352,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update or create one or more spend or receive money transaction
+    # Updates or creates one or more spent or received money transaction
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transactions [BankTransactions] 
     # @param [Hash] opts the optional parameters
@@ -16422,7 +16422,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update OR create one or more contacts in a Xero organisation
+    # Updates or creates one or more contacts in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contacts [Contacts] 
     # @param [Hash] opts the optional parameters
@@ -16433,7 +16433,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update OR create one or more contacts in a Xero organisation
+    # Updates or creates one or more contacts in a Xero organisation
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contacts [Contacts] 
     # @param [Hash] opts the optional parameters
@@ -16501,7 +16501,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update OR create one or more credit notes
+    # Updates or creates one or more credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_notes [CreditNotes] an array of Credit Notes with a single CreditNote object.
     # @param [Hash] opts the optional parameters
@@ -16513,7 +16513,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update OR create one or more credit notes
+    # Updates or creates one or more credit notes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_notes [CreditNotes] an array of Credit Notes with a single CreditNote object.
     # @param [Hash] opts the optional parameters
@@ -16583,7 +16583,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a single new employees used in Xero payrun
+    # Creates a single new employees used in Xero payrun
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param employees [Employees] Employees with array of Employee object in body of request
     # @param [Hash] opts the optional parameters
@@ -16594,7 +16594,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a single new employees used in Xero payrun
+    # Creates a single new employees used in Xero payrun
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param employees [Employees] Employees with array of Employee object in body of request
     # @param [Hash] opts the optional parameters
@@ -16662,7 +16662,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update OR create one or more sales invoices or purchase bills
+    # Updates or creates one or more sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoices [Invoices] 
     # @param [Hash] opts the optional parameters
@@ -16674,7 +16674,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update OR create one or more sales invoices or purchase bills
+    # Updates or creates one or more sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoices [Invoices] 
     # @param [Hash] opts the optional parameters
@@ -16744,7 +16744,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update or create one or more items
+    # Updates or creates one or more items
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param items [Items] 
     # @param [Hash] opts the optional parameters
@@ -16756,7 +16756,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update or create one or more items
+    # Updates or creates one or more items
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param items [Items] 
     # @param [Hash] opts the optional parameters
@@ -16826,7 +16826,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a single manual journal
+    # Updates or creates a single manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journals [ManualJournals] ManualJournals array with ManualJournal object in body of request
     # @param [Hash] opts the optional parameters
@@ -16837,7 +16837,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a single manual journal
+    # Updates or creates a single manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journals [ManualJournals] ManualJournals array with ManualJournal object in body of request
     # @param [Hash] opts the optional parameters
@@ -16905,7 +16905,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update or create one or more purchase orders
+    # Updates or creates one or more purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_orders [PurchaseOrders] 
     # @param [Hash] opts the optional parameters
@@ -16916,7 +16916,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update or create one or more purchase orders
+    # Updates or creates one or more purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_orders [PurchaseOrders] 
     # @param [Hash] opts the optional parameters
@@ -16984,7 +16984,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update OR create one or more quotes
+    # Updates or creates one or more quotes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quotes [Quotes] 
     # @param [Hash] opts the optional parameters
@@ -16995,7 +16995,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update OR create one or more quotes
+    # Updates or creates one or more quotes
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quotes [Quotes] 
     # @param [Hash] opts the optional parameters
@@ -17063,7 +17063,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified purchase order
+    # Updates a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param purchase_orders [PurchaseOrders] 
@@ -17074,7 +17074,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified purchase order
+    # Updates a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param purchase_orders [PurchaseOrders] 
@@ -17145,7 +17145,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on Purchase Order by Filename
+    # Updates a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -17157,7 +17157,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on Purchase Order by Filename
+    # Updates a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -17233,7 +17233,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified quote
+    # Updates a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param quotes [Quotes] 
@@ -17244,7 +17244,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified quote
+    # Updates a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for an Quote
     # @param quotes [Quotes] 
@@ -17315,7 +17315,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on Quote by Filename
+    # Updates a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -17327,7 +17327,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on Quote by Filename
+    # Updates a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -17403,7 +17403,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified draft expense claim receipts
+    # Updates a specific draft expense claim receipts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param receipts [Receipts] 
@@ -17415,7 +17415,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified draft expense claim receipts
+    # Updates a specific draft expense claim receipts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param receipts [Receipts] 
@@ -17488,7 +17488,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on expense claim receipts by file name
+    # Updates a specific attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -17500,7 +17500,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on expense claim receipts by file name
+    # Updates a specific attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -17576,7 +17576,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update specified attachment on repeating invoices by file name
+    # Updates a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -17588,7 +17588,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update specified attachment on repeating invoices by file name
+    # Updates a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -17664,7 +17664,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Tax Rates
+    # Updates tax rates
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tax_rates [TaxRates] 
     # @param [Hash] opts the optional parameters
@@ -17674,7 +17674,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Tax Rates
+    # Updates tax rates
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tax_rates [TaxRates] 
     # @param [Hash] opts the optional parameters
@@ -17740,7 +17740,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update tracking categories
+    # Updates a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_category [TrackingCategory] 
@@ -17751,7 +17751,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update tracking categories
+    # Updates a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_category [TrackingCategory] 
@@ -17822,7 +17822,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update options for a specified tracking category
+    # Updates a specific option for a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_option_id [String] Unique identifier for a Tracking Option
@@ -17834,7 +17834,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update options for a specified tracking category
+    # Updates a specific option for a specific tracking category
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param tracking_category_id [String] Unique identifier for a TrackingCategory
     # @param tracking_option_id [String] Unique identifier for a Tracking Option