xero-ruby 2.6.2 → 2.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac629bbf25ab4ffb1de61531dc83b88655157bff77e69b30385d7117f432c9db
-  data.tar.gz: 1f1741df2a1d4aa3b76668dced5b7b5dbc4e2a189f82b384b71dbb517484a1ae
+  metadata.gz: 91ccbdaae622f0b53bfdc151848a3d007715f908a40011a43fee02b4b4fc5e94
+  data.tar.gz: b33bdd7f93264219a7cc1f7f3b3395e9977a537c73b7735cec432ad7cae89de6
 SHA512:
-  metadata.gz: 56ce2386be68427b63d2dad049780ac1d6cd670eedc8f5d0c28072a9feb41777b5ca672137f59cdd1fb14fa861ec3be4b75e49fc8b833db5ead20d9cd67b6129
-  data.tar.gz: 49d77102f9918b211f303639170aeedabc34d1cf7df6084d64f9c2ff6751654c506fec1967bdc7d8c6a94f61c44bfc0f11138d7144da1ef3abf1415e3a12bcae
+  metadata.gz: 706da5b8834ea82840406d239472ad87f3b7b7ac6168f08e93ce9f2fea2f66b4a3ff473f74172fead3465b91113c99867bd1c5ca5da16159a284e11abdae26c7
+  data.tar.gz: 249d873213e1e2cfec1d015ca0c112d9893a281ee71593f5cc6ebdda5e951dfe5ff9e742bd666d8f3a9b63b881347180db9e2e01e3ef22b2edcca7deff427c47

data/README.md

@@ -1,28 +1,22 @@
 # 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.1-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.
 
-## API Client Docs
-* [Accounting Api Docs](/docs/accounting/AccountingApi.md)
-* [Asset Api Docs](/docs/assets/AssetApi.md)
-* [Project Api Docs](docs/projects/ProjectApi.md)
-* [File Api Docs](docs/files/FileApi.md)
-* [Payroll Docs (AU)](docs/payroll_au/PayrollAuApi.md)
-* [Payroll Docs (NZ)](docs/payroll_nz/PayrollNzApi.md)
-* [Payroll Docs (UK)](docs/payroll_uk/PayrollUkApi.md)
-
+## SDK Documentation
+* [API client methods](https://xeroapi.github.io/xero-ruby/accounting/index.html)
+---
 ## API Model Docs
-* [Accounting Models Docs](/docs/accounting/)
-* [Asset Models Docs](/docs/assets/)
-* [Project Models Docs](/docs/projects/)
-* [File Models Docs](/docs/files/)
-* [Payroll Models (AU)](docs/payroll_au/)
-* [Payroll Models (NZ)](docs/payroll_nz/)
-* [Payroll Models (UK)](docs/payroll_uk/)
+* [Accounting Models](/docs/accounting)
+* [Asset Api Docs](/docs/assets/)
+* [Project Api Docs](docs/projects/)
+* [Files Api Docs](docs/files/)
+* [Payroll Docs (AU)](docs/payroll_au/)
+* [Payroll Docs (NZ)](docs/payroll_nz/)
+* [Payroll Docs (UK)](docs/payroll_uk/)
 
 ## Sample Apps
 We have two apps showing SDK usage.
@@ -31,9 +25,6 @@ We have two apps showing SDK usage.
 
 ![sample-app](https://i.imgur.com/OOEn55G.png)
 
-## Looking for OAuth 1.0a support?
-Check out the [Xeroizer](https://github.com/waynerobinson/xeroizer) gem (maintained by community).
-
 ---
 ## Installation
 To install this gem to your current gemset.
@@ -49,9 +40,9 @@ gem 'xero-ruby'
 * Create a [free Xero user account](https://www.xero.com/us/signup/api/)
 * Login to your Xero developer [/myapps](https://developer.xero.com/myapps) dashboard & create an API application and note your API app's credentials.
 
-### Creating a Client
+### 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 a space-separated 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'
@@ -77,10 +68,11 @@ To generate a valid `token_set` send a user to the `authorization_url`:
 redirect_to @authorization_url
 ```
 
-Xero will then redirect back to the URI defined in your ENV['REDIRECT_URI'] variable.
+Xero will then redirect back to the URI defined in your `redirect_uri` config.
+
 *This must match **exactly** with the variable in your /myapps dashboard.*
 
-In your callback route catch, calling `get_token_set_from_callback` will exchange the temp code in your params, with a valid `token_set` that you can use to make API calls.
+In your callback, calling `get_token_set_from_callback` will exchange the temporary code Xero return, with a valid `token_set` that you can use to make API calls.
 ```ruby
 # => http://localhost:3000/oauth/callback
 
@@ -93,11 +85,12 @@ puts params['state']
 ```
 
 ## Making API calls once you have a token_set
-For use outside of the initial auth flow, setup the client by passing the whole token_set to `refresh_token_set` or `set_token_set`.
+Once you already have a token_set stored from this initual user interaction, you can setup a new client by passing the whole token_set to `refresh_token_set` or `set_token_set`.
 ```ruby
-xero_client.refresh_token_set(user.token_set)
-
 xero_client.set_token_set(user.token_set)
+
+xero_client.refresh_token_set(user.token_set)
+# this will set the access_token on the client, and return a refreshed `token_set` you need to save.
 ```
 A `token_set` contains data about your API connection most importantly :
 * `access_token`
@@ -138,6 +131,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 +153,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
@@ -166,6 +164,7 @@ end
 ## API Usage
 
 ### Accounting API
+> https://xeroapi.github.io/xero-ruby/accounting/index.html
 ```ruby
 require 'xero-ruby'
 
@@ -174,8 +173,6 @@ xero_client.refresh_token_set(user.token_set)
 tenant_id = user.active_tenant_id
 # example of how to store the `tenantId` of the specific tenant (aka organisation)
 
-# https://github.com/XeroAPI/xero-ruby/blob/master/accounting/lib/xero-ruby/api/accounting_api.rb
-
 # Get Accounts
 accounts = xero_client.accounting_api.get_accounts(tenant_id).accounts
 
@@ -184,7 +181,7 @@ invoices = { invoices: [{ type: XeroRuby::Accounting::Invoice::ACCREC, contact:
 invoice = xero_client.accounting_api.create_invoices(tenant_id, invoices).invoices.first
 
 # display out all the serialized data as a hash
-puts invoices.attributes
+puts invoices.to_attributes
 => {type: 'ACCREC', line_items: [...]}
 
 # Create History
@@ -203,10 +200,8 @@ attachment = xero_client.accounting_api.create_account_attachment_by_file_name(t
 ```
 
 ### Assets API
+> https://github.com/XeroAPI/xero-ruby/blob/master/accounting/lib/xero-ruby/api/asset_api.rb
 ```ruby
-# https://github.com/XeroAPI/xero-ruby/blob/master/accounting/lib/xero-ruby/api/asset_api.rb
-  
-# Create Asset
 asset = {
   "assetName": "AssetName: #{rand(10000)}",
   "assetNumber": "Asset: #{rand(10000)}",
@@ -216,18 +211,14 @@ asset = xero_client.asset_api.create_asset(tenant_id, asset)
 ```
 
 ### Project API
+> https://github.com/XeroAPI/xero-ruby/blob/master/docs/projects/ProjectApi.md
 ```ruby
-# https://github.com/XeroAPI/xero-ruby/blob/master/docs/projects/ProjectApi.md
-
-# Get Projects
 projects = xero_client.project_api.get_projects(tenant_id).items
 ```
 
 ### Files API
+> https://github.com/XeroAPI/xero-ruby/blob/master/docs/files/FileApi.md
 ```ruby
-# https://github.com/XeroAPI/xero-ruby/blob/master/docs/files/FileApi.md
-
-# Get Files
 opts = {
   pagesize: 50, # Integer | pass an optional page size value
   page: 2, # Integer | number of records to skip for pagination
@@ -299,11 +290,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,
@@ -328,7 +329,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.
 
@@ -345,15 +346,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,13 +287,12 @@ 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'
-require 'xero-ruby/models/files/inline_object'
 require 'xero-ruby/models/files/object_group'
 require 'xero-ruby/models/files/object_type'
+require 'xero-ruby/models/files/upload_object'
 require 'xero-ruby/models/files/user'
 require 'xero-ruby/models/projects/amount'
 require 'xero-ruby/models/projects/charge_type'
@@ -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,10 +180,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -192,10 +192,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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
@@ -510,7 +510,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -521,7 +521,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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
@@ -921,7 +921,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -932,7 +932,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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,10 +1409,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_online Allows an attachment to be seen by the end customer within their online invoice (default to false)
@@ -1422,10 +1422,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_online Allows an attachment to be seen by the end customer within their online invoice
@@ -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,10 +1977,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_online Allows an attachment to be seen by the end customer within their online invoice (default to false)
@@ -1990,10 +1990,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :include_online Allows an attachment to be seen by the end customer within their online invoice
@@ -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,10 +2472,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -2484,10 +2484,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -2560,9 +2560,9 @@ 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 manual_journal_id [String] Unique identifier for a ManualJournal
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
     # @param [Hash] opts the optional parameters
     # @return [HistoryRecords]
@@ -2571,9 +2571,9 @@ 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 manual_journal_id [String] Unique identifier for a ManualJournal
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(HistoryRecords, Integer, Hash)>] HistoryRecords data, response status code and response headers
@@ -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
@@ -3203,7 +3203,7 @@ module XeroRuby
 
     # Allows you to create an Allocation for prepayments
     # @param xero_tenant_id [String] Xero identifier for Tenant
-    # @param prepayment_id [String] Unique identifier for Prepayment
+    # @param prepayment_id [String] Unique identifier for a PrePayment
     # @param allocations [Allocations] Allocations with an array of Allocation object in body of request
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :summarize_errors If false return 200 OK and mix of successfully created objects and any with validation errors (default to false)
@@ -3215,7 +3215,7 @@ module XeroRuby
 
     # Allows you to create an Allocation for prepayments
     # @param xero_tenant_id [String] Xero identifier for Tenant
-    # @param prepayment_id [String] Unique identifier for Prepayment
+    # @param prepayment_id [String] Unique identifier for a PrePayment
     # @param allocations [Allocations] Allocations with an array of Allocation object in body of request
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :summarize_errors If false return 200 OK and mix of successfully created objects and any with validation errors
@@ -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,9 +3368,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -3380,9 +3380,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -3456,9 +3456,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
     # @param [Hash] opts the optional parameters
     # @return [HistoryRecords]
@@ -3467,9 +3467,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(HistoryRecords, Integer, Hash)>] HistoryRecords data, response status code and response headers
@@ -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,9 +3617,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -3629,9 +3629,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -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,10 +3945,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -3957,10 +3957,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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,10 +4115,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -4127,10 +4127,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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,9 +4519,9 @@ 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 account_id [String] Unique identifier for Account object
     # @param [Hash] opts the optional parameters
     # @return [Accounts]
     def delete_account(xero_tenant_id, account_id, opts = {})
@@ -4529,9 +4529,9 @@ 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 account_id [String] Unique identifier for Account object
     # @param [Hash] opts the optional parameters
     # @return [Array<(Accounts, Integer, Hash)>] Accounts data, response status code and response headers
     def delete_account_with_http_info(xero_tenant_id, account_id, opts = {})
@@ -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,9 +5211,9 @@ 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 account_id [String] Unique identifier for Account object
     # @param [Hash] opts the optional parameters
     # @return [Accounts]
     def get_account(xero_tenant_id, account_id, opts = {})
@@ -5221,9 +5221,9 @@ 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 account_id [String] Unique identifier for Account object
     # @param [Hash] opts the optional parameters
     # @return [Array<(Accounts, Integer, Hash)>] Accounts data, response status code and response headers
     def get_account_with_http_info(xero_tenant_id, account_id, opts = {})
@@ -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,10 +5687,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -5699,10 +5699,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -5774,10 +5774,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -5786,10 +5786,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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,10 +6166,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -6178,10 +6178,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -6253,10 +6253,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -6265,10 +6265,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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,10 +7006,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -7018,10 +7018,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -7093,10 +7093,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -7105,10 +7105,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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,10 +7861,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -7873,10 +7873,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -7948,10 +7948,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -7960,10 +7960,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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,10 +8867,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -8879,10 +8879,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -8954,10 +8954,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -8966,10 +8966,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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
@@ -9268,7 +9268,7 @@ module XeroRuby
     # @option opts [Array<String>] :contact_i_ds Filter by a comma-separated list of ContactIDs.
     # @option opts [Array<String>] :statuses Filter by a comma-separated list Statuses. For faster response times we recommend using these explicit parameters instead of passing OR conditions into the Where filter.
     # @option opts [Integer] :page e.g. page&#x3D;1 – Up to 100 invoices will be returned in a single API call with line items shown for each invoice
-    # @option opts [Boolean] :include_archived e.g. includeArchived&#x3D;true - Contacts with a status of ARCHIVED will be included in the response
+    # @option opts [Boolean] :include_archived e.g. includeArchived&#x3D;true - Invoices with a status of ARCHIVED will be included in the response
     # @option opts [Boolean] :created_by_my_app When set to true you&#39;ll only retrieve Invoices created by your app
     # @option opts [Integer] :unitdp e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
     # @return [Invoices]
@@ -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
@@ -9288,7 +9288,7 @@ module XeroRuby
     # @option opts [Array<String>] :contact_i_ds Filter by a comma-separated list of ContactIDs.
     # @option opts [Array<String>] :statuses Filter by a comma-separated list Statuses. For faster response times we recommend using these explicit parameters instead of passing OR conditions into the Where filter.
     # @option opts [Integer] :page e.g. page&#x3D;1 – Up to 100 invoices will be returned in a single API call with line items shown for each invoice
-    # @option opts [Boolean] :include_archived e.g. includeArchived&#x3D;true - Contacts with a status of ARCHIVED will be included in the response
+    # @option opts [Boolean] :include_archived e.g. includeArchived&#x3D;true - Invoices with a status of ARCHIVED will be included in the response
     # @option opts [Boolean] :created_by_my_app When set to true you&#39;ll only retrieve Invoices created by your app
     # @option opts [Integer] :unitdp e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
     # @return [Array<(Invoices, Integer, Hash)>] Invoices data, response status code and response headers
@@ -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,10 +9974,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -9986,10 +9986,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -10061,10 +10061,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -10073,10 +10073,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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,9 +10302,9 @@ 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 manual_journal_id [String] Unique identifier for a ManualJournal
     # @param [Hash] opts the optional parameters
     # @return [HistoryRecords]
     def get_manual_journals_history(xero_tenant_id, manual_journal_id, opts = {})
@@ -10312,9 +10312,9 @@ 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 manual_journal_id [String] Unique identifier for a ManualJournal
     # @param [Hash] opts the optional parameters
     # @return [Array<(HistoryRecords, Integer, Hash)>] HistoryRecords data, response status code and response headers
     def get_manual_journals_history_with_http_info(xero_tenant_id, manual_journal_id, opts = {})
@@ -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,9 +11418,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
     # @return [PurchaseOrders]
     def get_purchase_order(xero_tenant_id, purchase_order_id, opts = {})
@@ -11428,9 +11428,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchaseOrders, Integer, Hash)>] PurchaseOrders data, response status code and response headers
     def get_purchase_order_with_http_info(xero_tenant_id, purchase_order_id, opts = {})
@@ -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,9 +11566,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -11578,9 +11578,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -11653,9 +11653,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -11665,9 +11665,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -11740,9 +11740,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
     def get_purchase_order_attachments(xero_tenant_id, purchase_order_id, opts = {})
@@ -11750,9 +11750,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
     def get_purchase_order_attachments_with_http_info(xero_tenant_id, purchase_order_id, opts = {})
@@ -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,9 +11888,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
     # @return [HistoryRecords]
     def get_purchase_order_history(xero_tenant_id, purchase_order_id, opts = {})
@@ -11898,9 +11898,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param [Hash] opts the optional parameters
     # @return [Array<(HistoryRecords, Integer, Hash)>] HistoryRecords data, response status code and response headers
     def get_purchase_order_history_with_http_info(xero_tenant_id, purchase_order_id, opts = {})
@@ -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,9 +12200,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -12212,9 +12212,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -12287,9 +12287,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -12299,9 +12299,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
@@ -12374,9 +12374,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
     def get_quote_attachments(xero_tenant_id, quote_id, opts = {})
@@ -12384,9 +12384,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
     def get_quote_attachments_with_http_info(xero_tenant_id, quote_id, opts = {})
@@ -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,10 +12697,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -12709,10 +12709,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -12784,10 +12784,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -12796,10 +12796,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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,10 +13173,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -13185,10 +13185,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -13260,10 +13260,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [File]
@@ -13272,10 +13272,10 @@ 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
+    # @param attachment_id [String] Unique identifier for Attachment object
     # @param content_type [String] The mime type of the attachment file you are retrieving i.e image/jpg, application/pdf
     # @param [Hash] opts the optional parameters
     # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
@@ -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,26 +13569,26 @@ 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
     # @option opts [Date] :date The date of the Aged Payables By Contact report
-    # @option opts [Date] :from_date The from date of the Aged Payables By Contact report
-    # @option opts [Date] :to_date The to date of the Aged Payables By Contact report
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @return [ReportWithRows]
     def get_report_aged_payables_by_contact(xero_tenant_id, contact_id, opts = {})
       data, _status_code, _headers = get_report_aged_payables_by_contact_with_http_info(xero_tenant_id, contact_id, opts)
       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
     # @option opts [Date] :date The date of the Aged Payables By Contact report
-    # @option opts [Date] :from_date The from date of the Aged Payables By Contact report
-    # @option opts [Date] :to_date The to date of the Aged Payables By Contact report
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @return [Array<(ReportWithRows, Integer, Hash)>] ReportWithRows data, response status code and response headers
     def get_report_aged_payables_by_contact_with_http_info(xero_tenant_id, contact_id, opts = {})
       if @api_client.config.debugging
@@ -13653,26 +13653,26 @@ 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
     # @option opts [Date] :date The date of the Aged Receivables By Contact report
-    # @option opts [Date] :from_date The from date of the Aged Receivables By Contact report
-    # @option opts [Date] :to_date The to date of the Aged Receivables By Contact report
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @return [ReportWithRows]
     def get_report_aged_receivables_by_contact(xero_tenant_id, contact_id, opts = {})
       data, _status_code, _headers = get_report_aged_receivables_by_contact_with_http_info(xero_tenant_id, contact_id, opts)
       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
     # @option opts [Date] :date The date of the Aged Receivables By Contact report
-    # @option opts [Date] :from_date The from date of the Aged Receivables By Contact report
-    # @option opts [Date] :to_date The to date of the Aged Receivables By Contact report
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @return [Array<(ReportWithRows, Integer, Hash)>] ReportWithRows data, response status code and response headers
     def get_report_aged_receivables_by_contact_with_http_info(xero_tenant_id, contact_id, opts = {})
       if @api_client.config.debugging
@@ -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,22 +13972,22 @@ 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
-    # @option opts [Date] :to_date The to date for the Bank Summary report e.g. 2018-03-31
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @return [ReportWithRows]
     def get_report_bank_summary(xero_tenant_id, opts = {})
       data, _status_code, _headers = get_report_bank_summary_with_http_info(xero_tenant_id, opts)
       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
-    # @option opts [Date] :to_date The to date for the Bank Summary report e.g. 2018-03-31
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @return [Array<(ReportWithRows, Integer, Hash)>] ReportWithRows data, response status code and response headers
     def get_report_bank_summary_with_http_info(xero_tenant_id, opts = {})
       if @api_client.config.debugging
@@ -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,11 +14194,11 @@ 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
-    # @option opts [Date] :to_date The to date for the ProfitAndLoss report e.g. 2018-03-31
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @option opts [Integer] :periods The number of periods to compare (integer between 1 and 12)
     # @option opts [String] :timeframe The period size to compare to (MONTH, QUARTER, YEAR)
     # @option opts [String] :tracking_category_id The trackingCategory 1 for the ProfitAndLoss report
@@ -14213,11 +14213,11 @@ 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
-    # @option opts [Date] :to_date The to date for the ProfitAndLoss report e.g. 2018-03-31
+    # @option opts [Date] :from_date filter by the from date of the report e.g. 2021-02-01
+    # @option opts [Date] :to_date filter by the to date of the report e.g. 2021-02-28
     # @option opts [Integer] :periods The number of periods to compare (integer between 1 and 12)
     # @option opts [String] :timeframe The period size to compare to (MONTH, QUARTER, YEAR)
     # @option opts [String] :tracking_category_id The trackingCategory 1 for the ProfitAndLoss report
@@ -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,9 +14896,9 @@ 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 account_id [String] Unique identifier for Account object
     # @param accounts [Accounts] Request of type Accounts array with one Account
     # @param [Hash] opts the optional parameters
     # @return [Accounts]
@@ -14907,9 +14907,9 @@ 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 account_id [String] Unique identifier for Account object
     # @param accounts [Accounts] Request of type Accounts array with one Account
     # @param [Hash] opts the optional parameters
     # @return [Array<(Accounts, Integer, Hash)>] Accounts data, response status code and response headers
@@ -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,10 +15151,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -15163,10 +15163,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -15241,7 +15241,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -15252,7 +15252,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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
@@ -15409,7 +15409,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -15420,7 +15420,7 @@ module XeroRuby
 
     # @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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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,10 +15660,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -15672,10 +15672,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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,10 +15915,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -15927,10 +15927,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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,10 +16252,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -16264,10 +16264,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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,9 +17063,9 @@ 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_order_id [String] Unique identifier for an Purchase Order
     # @param purchase_orders [PurchaseOrders] 
     # @param [Hash] opts the optional parameters
     # @return [PurchaseOrders]
@@ -17074,9 +17074,9 @@ 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_order_id [String] Unique identifier for an Purchase Order
     # @param purchase_orders [PurchaseOrders] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(PurchaseOrders, Integer, Hash)>] PurchaseOrders data, response status code and response headers
@@ -17145,9 +17145,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -17157,9 +17157,9 @@ 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 purchase_order_id [String] Unique identifier for an Purchase Order
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -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,9 +17315,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -17327,9 +17327,9 @@ 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 quote_id [String] Unique identifier for an Quote
     # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
@@ -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,10 +17488,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -17500,10 +17500,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -17576,10 +17576,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Attachments]
@@ -17588,10 +17588,10 @@ 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
+    # @param file_name [String] Name of the attachment
     # @param body [String] Byte array of file in body of request
     # @param [Hash] opts the optional parameters
     # @return [Array<(Attachments, Integer, Hash)>] Attachments data, response status code and response headers
@@ -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