xero-ruby 2.5.0 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 613096db0ddc85e2e704679043b677e2c683f030bba7ec74ff034914cb249950
-  data.tar.gz: c988f99601ed4c160a132b85d6bccee2e106a68916f4b6b1792ec718820068f0
+  metadata.gz: 30a7bb87ce9cfceb77f481f5cdc6359b767aa5fec1f4026bd21fb79b8de303f3
+  data.tar.gz: 60992fcee98c7e596922ef53b5a7f8f4e10cacc690306c35155d8139d602eeaa
 SHA512:
-  metadata.gz: 30410e6a6f12a11eb98faf3005054107b74b34c70faf05b388d79f05cfb56a9a782774bf7e1a7dc8fd0059384283659993d6bb47b8a1ece75d6ff570c30e3d4c
-  data.tar.gz: e40707ba182c142624c274d3df126952d1307fe8362ca68358ee1e9d667be3e05f3c9dab1177464004104ba7e876af95bf4e713bc165e0e5db843129e491f55e
+  metadata.gz: 4cc57b00a6dd63d307bc2073270bf41f96135a7e866c2815c2fd802e5ecfb87d1f2187e83fb9001ad66c880c0c49f16a821e2e09fd20d7cf35b84a606357d909
+  data.tar.gz: 2568596be9f223d4baac9d48d2b83a4df3eae8bacacc62b1f7fdc12a94a89ee79bf388607fe77ac55e5e5e85dddace40144e37eb5064801f0ef9a241ccb0aaae

data/README.md

@@ -1,10 +1,10 @@
 # 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-v0.2.4-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 supports the following Xero API sets.
+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)
@@ -51,7 +51,7 @@ gem 'xero-ruby'
 
 ### Creating a Client
 * Get the credential values from an API application at https://developer.xero.com/myapps/.
-* Include [neccesary scopes](https://developer.xero.com/documentation/oauth2/scopes) as comma seperated list
+* Include [neccesary scopes](https://developer.xero.com/documentation/oauth2/scopes) as a space-seperated list
     * example => "`openid profile email accounting.transactions accounting.settings`"
 ```
 require 'xero-ruby'
@@ -61,7 +61,8 @@ creds = {
   client_id: ENV['CLIENT_ID'],
   client_secret: ENV['CLIENT_SECRET'],
   redirect_uri: ENV['REDIRECT_URI'],
-  scopes: ENV['SCOPES']
+  scopes: ENV['SCOPES'],
+  state: "this-can-be-a-custom-state-parameter" # optional
 }
 xero_client ||= XeroRuby::ApiClient.new(credentials: creds)
 ```
@@ -86,6 +87,9 @@ In your callback route catch, calling `get_token_set_from_callback` will exchang
 token_set = xero_client.get_token_set_from_callback(params)
 
 # save token_set JSON in a datastore in relation to the user authentication
+
+puts params['state']
+=> "this-can-be-a-custom-state-parameter"
 ```
 
 ## Making API calls once you have a token_set
@@ -179,6 +183,10 @@ accounts = xero_client.accounting_api.get_accounts(tenant_id).accounts
 invoices = { invoices: [{ type: XeroRuby::Accounting::Invoice::ACCREC, contact: { contact_id: contacts[0].contact_id }, line_items: [{ description: "Big Agency", quantity: BigDecimal("2.0"), unit_amount: BigDecimal("50.99"), account_code: "600", tax_type: XeroRuby::Accounting::TaxType::NONE }], date: "2019-03-11", due_date: "2018-12-10", reference: "Website Design", status: XeroRuby::Accounting::Invoice::DRAFT }]}
 invoice = xero_client.accounting_api.create_invoices(tenant_id, invoices).invoices.first
 
+# display out all the serialized data as a hash
+puts invoices.attributes
+=> {type: 'ACCREC', line_items: [...]}
+
 # Create History
 payment = xero_client.accounting_api.get_payments(tenant_id).payments.first
 history_records = { history_records: [{ details: "This payment now has some History!" }]}
@@ -291,11 +299,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,
@@ -320,11 +338,32 @@ 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.
 
 ## Sample App
 The best resource to understanding how to best leverage this SDK is the sample applications showing all the features of the gem.
 > https://github.com/XeroAPI/xero-ruby-oauth2-starter (Sinatra - simple getting started)
-> https://github.com/XeroAPI/xero-ruby-oauth2-app (Rails - full featured examples)
+> https://github.com/XeroAPI/xero-ruby-oauth2-app (Rails - full featured examples)
+
+## Contributing
+Most of the repo code is auto generated but PR's on issues you encounter are highly encouraged. Xero maintainers will re-incorporate them back into the core SDK build. To develop this gem locally against your project you can use the following development pattern:
+
+> xero-ruby
+```bash
+gem build
+mv xero-ruby-<vsn>.gem xero-ruby.gem
+pwd
+=> /Users/your.user/code/sdks/xero-ruby/
+```
+
+> https://github.com/XeroAPI/xero-ruby-oauth2-app
+Replace gem file with local path:
+```bash
+gem 'xero-ruby', path: '/Users/your.user/code/sdks/xero-ruby/'
+bundle install
+```
+
+## Testing 
+* `rspec spec/`

data/lib/xero-ruby.rb

@@ -1,9 +1,8 @@
 =begin
-#Accounting API
+#Xero Accounting API
 
 #No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
-The version of the OpenAPI document: 2.8.0
 Contact: api@xero.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1
@@ -11,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'
@@ -286,7 +287,6 @@ require 'xero-ruby/models/payroll_au/timesheets'
 require 'xero-ruby/models/payroll_au/validation_error'
 require 'xero-ruby/models/files/association'
 require 'xero-ruby/models/files/file_object'
-require 'xero-ruby/models/files/file_response204'
 require 'xero-ruby/models/files/files'
 require 'xero-ruby/models/files/folder'
 require 'xero-ruby/models/files/folders'
@@ -350,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,9 +1,8 @@
 =begin
-#Accounting API
+#Xero Accounting API
 
 #No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
-The version of the OpenAPI document: 2.8.0
 Contact: api@xero.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 4.3.1
@@ -17,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
@@ -27,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
@@ -93,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
@@ -105,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
@@ -181,7 +180,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create an Attachment on BankTransaction by Filename
+    # Creates an attachment for a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -193,7 +192,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create an Attachment on BankTransaction by Filename
+    # Creates an attachment for a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -269,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
@@ -280,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
@@ -351,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
@@ -363,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
@@ -433,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
@@ -443,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
@@ -595,6 +594,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
+    # 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,6 +605,7 @@ module XeroRuby
       data
     end
 
+    # 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
@@ -675,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
@@ -686,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
@@ -754,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
@@ -765,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
@@ -836,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
@@ -847,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
@@ -1004,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
@@ -1014,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
@@ -1080,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 = {})
@@ -1091,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 = {})
@@ -1162,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
@@ -1173,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
@@ -1244,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
@@ -1255,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
@@ -1323,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.
@@ -1335,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.
@@ -1408,7 +1409,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachments on CreditNote by file name
+    # Creates an attachment for a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -1421,7 +1422,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachments on CreditNote by file name
+    # Creates an attachment for a specific credit note
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -1499,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
@@ -1510,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
@@ -1581,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
@@ -1593,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
@@ -1663,8 +1664,9 @@ module XeroRuby
       return data, status_code, headers
     end
 
+    # 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 = {})
@@ -1672,8 +1674,9 @@ module XeroRuby
       data
     end
 
+    # 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 = {})
@@ -1737,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
@@ -1748,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
@@ -1816,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
@@ -1827,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
@@ -1898,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
@@ -1908,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
@@ -1974,7 +1977,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create an Attachment on invoices or purchase bills by it's filename
+    # Creates an attachment for a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -1987,7 +1990,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create an Attachment on invoices or purchase bills by it&#39;s filename
+    # Creates an attachment for a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -2065,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
@@ -2076,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
@@ -2147,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
@@ -2159,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
@@ -2229,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
@@ -2240,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
@@ -2311,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
@@ -2323,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
@@ -2393,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
@@ -2403,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
@@ -2469,7 +2472,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create a specified Attachment on ManualJournal by file name
+    # Creates a specific attachment for a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -2481,7 +2484,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create a specified Attachment on ManualJournal by file name
+    # Creates a specific attachment for a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -2557,7 +2560,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create history record for a manual journal
+    # Creates a history record for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2568,7 +2571,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create history record for a manual journal
+    # Creates a history record for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -2639,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
@@ -2650,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
@@ -2718,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
@@ -2730,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
@@ -2803,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
@@ -2814,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
@@ -2885,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
@@ -2895,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
@@ -2961,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
@@ -2972,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
@@ -3043,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
@@ -3053,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
@@ -3119,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
@@ -3130,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
@@ -3283,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
@@ -3294,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
@@ -3365,7 +3368,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachment on Purchase Order
+    # Creates attachment for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -3377,7 +3380,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachment on Purchase Order
+    # Creates attachment for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -3453,7 +3456,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create HistoryRecord for purchase orders
+    # Creates a history record for a specific purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3464,7 +3467,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create HistoryRecord for purchase orders
+    # Creates a history record for a specific purchase orders
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param history_records [HistoryRecords] HistoryRecords containing an array of HistoryRecord objects in body of request
@@ -3535,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
@@ -3546,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
@@ -3614,7 +3617,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachment on Quote
+    # Creates attachment for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -3626,7 +3629,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachment on Quote
+    # Creates attachment for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -3702,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
@@ -3713,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
@@ -3784,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
@@ -3795,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
@@ -3863,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
@@ -3874,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
@@ -3942,7 +3945,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create Attachment on expense claim receipts by file name
+    # Creates an attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -3954,7 +3957,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create Attachment on expense claim receipts by file name
+    # Creates an attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -4030,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
@@ -4041,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
@@ -4112,7 +4115,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to create attachment on repeating invoices by file name
+    # Creates an attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -4124,7 +4127,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to create attachment on repeating invoices by file name
+    # Creates an attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -4200,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
@@ -4211,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
@@ -4282,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
@@ -4292,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
@@ -4358,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
@@ -4368,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
@@ -4434,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
@@ -4445,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
@@ -4516,7 +4519,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to delete a chart of accounts
+    # Deletes a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -4526,7 +4529,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to delete a chart of accounts
+    # Deletes a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -4590,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
@@ -4601,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
@@ -4670,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
@@ -4680,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
@@ -4742,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
@@ -4752,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
@@ -4816,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
@@ -4826,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
@@ -4890,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] 
@@ -4901,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] 
@@ -4972,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
@@ -4982,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
@@ -5046,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
@@ -5057,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
@@ -5126,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] 
@@ -5137,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] 
@@ -5208,7 +5211,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a single chart of accounts
+    # Retrieves a single chart of accounts by using a unique account Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -5218,7 +5221,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a single chart of accounts
+    # Retrieves a single chart of accounts by using a unique account Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param [Hash] opts the optional parameters
@@ -5282,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
@@ -5294,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
@@ -5369,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
@@ -5381,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
@@ -5456,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
@@ -5466,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
@@ -5530,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
@@ -5542,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
@@ -5607,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
@@ -5618,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
@@ -5684,7 +5687,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on BankTransaction by Filename
+    # Retrieves a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -5696,7 +5699,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on BankTransaction by Filename
+    # Retrieves a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -5771,7 +5774,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on a specific BankTransaction
+    # Retrieves specific attachments from a specific BankTransaction using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param attachment_id [String] Xero generated unique identifier for an attachment
@@ -5783,7 +5786,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on a specific BankTransaction
+    # Retrieves specific attachments from a specific BankTransaction using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param attachment_id [String] Xero generated unique identifier for an attachment
@@ -5858,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
@@ -5868,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
@@ -5932,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
@@ -5946,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
@@ -6015,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
@@ -6025,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
@@ -6089,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
@@ -6099,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
@@ -6163,7 +6166,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on BankTransfer by file name
+    # Retrieves a specific attachment on a specific bank transfer by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param file_name [String] The name of the file being attached to a Bank Transfer
@@ -6175,7 +6178,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on BankTransfer by file name
+    # Retrieves a specific attachment on a specific bank transfer by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param file_name [String] The name of the file being attached to a Bank Transfer
@@ -6250,7 +6253,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on BankTransfer
+    # Retrieves a specific attachment from a specific bank transfer using a unique attachment ID
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param attachment_id [String] Xero generated unique identifier for an Attachment to a bank transfer
@@ -6262,7 +6265,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on BankTransfer
+    # Retrieves a specific attachment from a specific bank transfer using a unique attachment ID
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transfer_id [String] Xero generated unique identifier for a bank transfer
     # @param attachment_id [String] Xero generated unique identifier for an Attachment to a bank transfer
@@ -6337,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
@@ -6347,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
@@ -6411,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
@@ -6421,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
@@ -6485,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
@@ -6497,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
@@ -6562,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
@@ -6572,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
@@ -6636,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
@@ -6648,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
@@ -6713,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
@@ -6723,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
@@ -6787,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
@@ -6797,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
@@ -6861,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]
@@ -6870,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
@@ -6929,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
@@ -6939,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
@@ -7003,7 +7006,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on Contacts by file name
+    # Retrieves a specific attachment from a specific contact by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param file_name [String] Name for the file you are attaching
@@ -7015,7 +7018,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on Contacts by file name
+    # Retrieves a specific attachment from a specific contact by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param file_name [String] Name for the file you are attaching
@@ -7090,7 +7093,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on Contacts
+    # Retrieves a specific attachment from a specific contact using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -7102,7 +7105,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on Contacts
+    # Retrieves a specific attachment from a specific contact using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -7177,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
@@ -7187,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
@@ -7251,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
@@ -7261,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
@@ -7325,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
@@ -7335,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
@@ -7399,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
@@ -7409,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
@@ -7473,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
@@ -7484,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
@@ -7547,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
@@ -7557,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
@@ -7621,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
@@ -7636,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
@@ -7707,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
@@ -7718,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
@@ -7784,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
@@ -7794,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
@@ -7858,7 +7861,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on CreditNote by file name
+    # Retrieves a specific attachment on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -7870,7 +7873,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on CreditNote by file name
+    # Retrieves a specific attachment on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -7945,7 +7948,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on CreditNote
+    # Retrieves a specific attachment from a specific credit note using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -7957,7 +7960,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on CreditNote
+    # Retrieves a specific attachment from a specific credit note using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -8032,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
@@ -8042,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
@@ -8106,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
@@ -8116,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
@@ -8180,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
@@ -8194,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
@@ -8263,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
@@ -8274,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
@@ -8337,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
@@ -8347,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
@@ -8411,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
@@ -8423,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
@@ -8488,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
@@ -8498,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
@@ -8562,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
@@ -8572,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
@@ -8636,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
@@ -8648,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
@@ -8713,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
@@ -8724,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
@@ -8790,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
@@ -8800,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
@@ -8864,7 +8867,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment on invoices or purchase bills by it's filename
+    # Retrieves an attachment from a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -8876,7 +8879,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment on invoices or purchase bills by it&#39;s filename
+    # Retrieves an attachment from a specific invoice or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -8951,7 +8954,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified Attachment on invoices or purchase bills by it's ID
+    # Retrieves a specific attachment from a specific invoices or purchase bills by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param attachment_id [String] Unique identifier for an Attachment
@@ -8963,7 +8966,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified Attachment on invoices or purchase bills by it&#39;s ID
+    # Retrieves a specific attachment from a specific invoices or purchase bills by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param attachment_id [String] Unique identifier for an Attachment
@@ -9038,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
@@ -9048,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
@@ -9112,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
@@ -9122,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
@@ -9186,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]
@@ -9195,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
@@ -9254,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
@@ -9274,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
@@ -9355,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
@@ -9366,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
@@ -9432,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
@@ -9442,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
@@ -9506,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
@@ -9519,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
@@ -9586,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
@@ -9596,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
@@ -9660,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
@@ -9672,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
@@ -9737,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
@@ -9747,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
@@ -9811,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 = {})
@@ -9826,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 = {})
@@ -9897,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
@@ -9907,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
@@ -9971,7 +9974,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournal by file name
+    # Retrieves a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -9983,7 +9986,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournal by file name
+    # Retrieves a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -10058,7 +10061,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournals
+    # Allows you to retrieve a specific attachment from a specific manual journal using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -10070,7 +10073,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specified Attachment on ManualJournals
+    # Allows you to retrieve a specific attachment from a specific manual journal using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -10145,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
@@ -10155,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
@@ -10219,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
@@ -10232,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
@@ -10299,7 +10302,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history from a manual journal
+    # Retrieves history for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param [Hash] opts the optional parameters
@@ -10309,7 +10312,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history from a manual journal
+    # Retrieves history for a specific manual journal
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Xero generated unique identifier for a manual journal
     # @param [Hash] opts the optional parameters
@@ -10373,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
@@ -10383,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
@@ -10447,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]
@@ -10456,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
@@ -10515,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 ...'
@@ -10568,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']
@@ -10589,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]
@@ -10598,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
@@ -10657,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
@@ -10667,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
@@ -10731,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
@@ -10741,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
@@ -10805,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
@@ -10819,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
@@ -10888,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
@@ -10898,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
@@ -10962,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
@@ -10972,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
@@ -11036,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]
@@ -11045,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
@@ -11104,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
@@ -11117,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
@@ -11258,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
@@ -11268,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
@@ -11332,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
@@ -11346,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
@@ -11415,7 +11418,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified purchase orders
+    # Retrieves a specific purchase order using a unique purchase order Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11425,7 +11428,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified purchase orders
+    # Retrieves a specific purchase order using a unique purchase order Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11489,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
@@ -11499,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
@@ -11563,7 +11566,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment on a Purchase Order by Filename
+    # Retrieves a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -11575,7 +11578,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment on a Purchase Order by Filename
+    # Retrieves a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -11650,7 +11653,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specific Attachment on purchase order
+    # Retrieves specific attachment for a specific purchase order using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -11662,7 +11665,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specific Attachment on purchase order
+    # Retrieves specific attachment for a specific purchase order using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -11737,7 +11740,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve attachments for purchase orders
+    # Retrieves attachments for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Orders object
     # @param [Hash] opts the optional parameters
@@ -11747,7 +11750,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve attachments for purchase orders
+    # Retrieves attachments for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Orders object
     # @param [Hash] opts the optional parameters
@@ -11811,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
@@ -11821,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
@@ -11885,7 +11888,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve history for PurchaseOrder
+    # Retrieves history for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11895,7 +11898,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve history for PurchaseOrder
+    # Retrieves history for a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param [Hash] opts the optional parameters
@@ -11959,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
@@ -11974,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
@@ -12049,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
@@ -12059,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
@@ -12123,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
@@ -12133,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
@@ -12197,7 +12200,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachment on Quote by Filename
+    # Retrieves a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -12209,7 +12212,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachment on Quote by Filename
+    # Retrieves a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -12284,7 +12287,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specific Attachment on Quote
+    # Retrieves a specific attachment from a specific quote using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -12296,7 +12299,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specific Attachment on Quote
+    # Retrieves a specific attachment from a specific quote using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param attachment_id [String] Unique identifier for Attachment object
@@ -12371,7 +12374,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments for Quotes
+    # Retrieves attachments for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param [Hash] opts the optional parameters
@@ -12381,7 +12384,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments for Quotes
+    # Retrieves attachments for a specific quote
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param [Hash] opts the optional parameters
@@ -12445,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
@@ -12455,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
@@ -12519,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
@@ -12538,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
@@ -12617,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
@@ -12628,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
@@ -12694,7 +12697,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by file name
+    # Retrieves a specific attachment from a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -12706,7 +12709,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by file name
+    # Retrieves a specific attachment from a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -12781,7 +12784,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by ID
+    # Retrieves a specific attachments from a specific expense claim receipts by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -12793,7 +12796,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve Attachments on expense claim receipts by ID
+    # Retrieves a specific attachments from a specific expense claim receipts by using a unique attachment Id
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -12868,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
@@ -12878,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
@@ -12942,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
@@ -12952,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
@@ -13016,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
@@ -13029,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
@@ -13096,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
@@ -13106,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
@@ -13170,7 +13173,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve specified attachment on repeating invoices by file name
+    # Retrieves a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -13182,7 +13185,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve specified attachment on repeating invoices by file name
+    # Retrieves a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -13257,7 +13260,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve a specified Attachments on repeating invoices
+    # Retrieves a specific attachment from a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -13269,7 +13272,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve a specified Attachments on repeating invoices
+    # Retrieves a specific attachment from a specific repeating invoice
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param attachment_id [String] Unique identifier for a Attachment
@@ -13344,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
@@ -13354,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
@@ -13418,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
@@ -13428,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
@@ -13492,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
@@ -13503,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
@@ -13566,7 +13569,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for AgedPayablesByContact
+    # Retrieves report for aged payables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13579,7 +13582,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for AgedPayablesByContact
+    # Retrieves report for aged payables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13650,7 +13653,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for AgedReceivablesByContact
+    # Retrieves report for aged receivables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13663,7 +13666,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for AgedReceivablesByContact
+    # Retrieves report for aged receivables by contact
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param contact_id [String] Unique identifier for a Contact
     # @param [Hash] opts the optional parameters
@@ -13734,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
@@ -13744,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
@@ -13808,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]
@@ -13817,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
@@ -13876,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
@@ -13892,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
@@ -13969,7 +13972,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for BankSummary
+    # Retrieves report for bank summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the Bank Summary report e.g. 2018-03-31
@@ -13980,7 +13983,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for BankSummary
+    # Retrieves report for bank summary
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the Bank Summary report e.g. 2018-03-31
@@ -14043,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
@@ -14055,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
@@ -14120,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
@@ -14130,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
@@ -14191,7 +14194,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to retrieve report for ProfitAndLoss
+    # Retrieves report for profit and loss
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the ProfitAndLoss report e.g. 2018-03-31
@@ -14210,7 +14213,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to retrieve report for ProfitAndLoss
+    # Retrieves report for profit and loss
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param [Hash] opts the optional parameters
     # @option opts [Date] :from_date The from date for the ProfitAndLoss report e.g. 2018-03-31
@@ -14293,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
@@ -14303,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
@@ -14364,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
@@ -14375,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
@@ -14438,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
@@ -14450,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
@@ -14515,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
@@ -14527,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
@@ -14592,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
@@ -14602,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
@@ -14666,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
@@ -14676,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
@@ -14740,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
@@ -14752,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
@@ -14817,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
@@ -14827,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
@@ -14893,7 +14896,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a chart of accounts
+    # Updates a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param accounts [Accounts] Request of type Accounts array with one Account
@@ -14904,7 +14907,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a chart of accounts
+    # Updates a chart of accounts
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param account_id [String] Unique identifier for retrieving single object
     # @param accounts [Accounts] Request of type Accounts array with one Account
@@ -14975,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
@@ -14987,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
@@ -15063,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] 
@@ -15075,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] 
@@ -15148,7 +15151,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update an Attachment on BankTransaction by Filename
+    # Updates a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -15160,7 +15163,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update an Attachment on BankTransaction by Filename
+    # Updates a specific attachment from a specific bank transaction by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param bank_transaction_id [String] Xero generated unique identifier for a bank transaction
     # @param file_name [String] The name of the file being attached
@@ -15322,6 +15325,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
+    # 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
@@ -15332,6 +15336,7 @@ module XeroRuby
       data
     end
 
+    # 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
@@ -15488,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
@@ -15499,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
@@ -15570,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
@@ -15582,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
@@ -15655,7 +15660,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachments on CreditNote by file name
+    # Updates attachments on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -15667,7 +15672,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachments on CreditNote by file name
+    # Updates attachments on a specific credit note by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param credit_note_id [String] Unique identifier for a Credit Note
     # @param file_name [String] Name of the file you are attaching to Credit Note
@@ -15743,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] 
@@ -15754,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] 
@@ -15825,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] 
@@ -15837,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] 
@@ -15910,7 +15915,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on invoices or purchase bills by it's filename
+    # Updates an attachment from a specific invoices or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -15922,7 +15927,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on invoices or purchase bills by it&#39;s filename
+    # Updates an attachment from a specific invoices or purchase bill by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
     # @param file_name [String] Name of the file you are attaching
@@ -15998,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] 
@@ -16010,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] 
@@ -16083,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] 
@@ -16094,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] 
@@ -16165,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] 
@@ -16176,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] 
@@ -16247,7 +16252,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified Attachment on ManualJournal by file name
+    # Updates a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -16259,7 +16264,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified Attachment on ManualJournal by file name
+    # Updates a specific attachment from a specific manual journal by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param manual_journal_id [String] Unique identifier for a ManualJournal
     # @param file_name [String] The name of the file being attached to a ManualJournal
@@ -16335,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
@@ -16347,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
@@ -16417,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
@@ -16428,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
@@ -16496,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
@@ -16508,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
@@ -16578,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
@@ -16589,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
@@ -16657,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
@@ -16669,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
@@ -16739,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
@@ -16751,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
@@ -16821,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
@@ -16832,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
@@ -16900,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
@@ -16911,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
@@ -16979,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
@@ -16990,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
@@ -17058,7 +17063,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update a specified purchase order
+    # Updates a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param purchase_orders [PurchaseOrders] 
@@ -17069,7 +17074,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update a specified purchase order
+    # Updates a specific purchase order
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for a PurchaseOrder
     # @param purchase_orders [PurchaseOrders] 
@@ -17140,7 +17145,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on Purchase Order by Filename
+    # Updates a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -17152,7 +17157,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on Purchase Order by Filename
+    # Updates a specific attachment for a specific purchase order by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param purchase_order_id [String] Unique identifier for Purchase Order object
     # @param file_name [String] Name of the attachment
@@ -17228,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] 
@@ -17239,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] 
@@ -17310,7 +17315,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on Quote by Filename
+    # Updates a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -17322,7 +17327,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on Quote by Filename
+    # Updates a specific attachment from a specific quote by filename
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param quote_id [String] Unique identifier for Quote object
     # @param file_name [String] Name of the attachment
@@ -17398,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] 
@@ -17410,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] 
@@ -17483,7 +17488,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update Attachment on expense claim receipts by file name
+    # Updates a specific attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -17495,7 +17500,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update Attachment on expense claim receipts by file name
+    # Updates a specific attachment on a specific expense claim receipts by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param receipt_id [String] Unique identifier for a Receipt
     # @param file_name [String] The name of the file being attached to the Receipt
@@ -17571,7 +17576,7 @@ module XeroRuby
       return data, status_code, headers
     end
 
-    # Allows you to update specified attachment on repeating invoices by file name
+    # Updates a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -17583,7 +17588,7 @@ module XeroRuby
       data
     end
 
-    # Allows you to update specified attachment on repeating invoices by file name
+    # Updates a specific attachment from a specific repeating invoices by file name
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param repeating_invoice_id [String] Unique identifier for a Repeating Invoice
     # @param file_name [String] The name of the file being attached to a Repeating Invoice
@@ -17659,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
@@ -17669,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
@@ -17735,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] 
@@ -17746,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] 
@@ -17817,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
@@ -17829,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