xero-ruby 2.4.1 → 2.5.0

data/docs/assets/AssetStatus.md

@@ -0,0 +1,16 @@
+# XeroRuby::Assets::AssetStatus
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::AssetStatus.new()
+```
+
+

data/docs/assets/AssetStatusQueryParam.md

@@ -0,0 +1,16 @@
+# XeroRuby::Assets::AssetStatusQueryParam
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::AssetStatusQueryParam.new()
+```
+
+

data/docs/assets/AssetType.md

@@ -0,0 +1,29 @@
+# XeroRuby::Assets::AssetType
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**asset_type_id** | **String** | Xero generated unique identifier for asset types | [optional] 
+**asset_type_name** | **String** | The name of the asset type | 
+**fixed_asset_account_id** | **String** | The asset account for fixed assets of this type | [optional] 
+**depreciation_expense_account_id** | **String** | The expense account for the depreciation of fixed assets of this type | [optional] 
+**accumulated_depreciation_account_id** | **String** | The account for accumulated depreciation of fixed assets of this type | [optional] 
+**book_depreciation_setting** | [**BookDepreciationSetting**](BookDepreciationSetting.md) |  | 
+**locks** | **Integer** | All asset types that have accumulated depreciation for any assets that use them are deemed ‘locked’ and cannot be removed. | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::AssetType.new(asset_type_id: 5da209c5-5e19-4a43-b925-71b776c49ced,
+                                 asset_type_name: Computer Equipment,
+                                 fixed_asset_account_id: 24e260f1-bfc4-4766-ad7f-8a8ce01de879,
+                                 depreciation_expense_account_id: b23fc79b-d66b-44b0-a240-e138e086fcbc,
+                                 accumulated_depreciation_account_id: ca4c6b39-4f4f-43e8-98da-5e1f350a6694,
+                                 book_depreciation_setting: null,
+                                 locks: 33)
+```
+
+

data/docs/assets/Assets.md

@@ -0,0 +1,19 @@
+# XeroRuby::Assets::Assets
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**pagination** | [**Pagination**](Pagination.md) |  | [optional] 
+**items** | [**Array<Asset>**](Asset.md) |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::Assets.new(pagination: null,
+                                 items: null)
+```
+
+

data/docs/assets/BookDepreciationDetail.md

@@ -0,0 +1,29 @@
+# XeroRuby::Assets::BookDepreciationDetail
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**current_capital_gain** | **BigDecimal** | When an asset is disposed, this will be the sell price minus the purchase price if a profit was made. | [optional] 
+**current_gain_loss** | **BigDecimal** | When an asset is disposed, this will be the lowest one of sell price or purchase price, minus the current book value. | [optional] 
+**depreciation_start_date** | **Date** | YYYY-MM-DD | [optional] 
+**cost_limit** | **BigDecimal** | The value of the asset you want to depreciate, if this is less than the cost of the asset. | [optional] 
+**residual_value** | **BigDecimal** | The value of the asset remaining when you've fully depreciated it. | [optional] 
+**prior_accum_depreciation_amount** | **BigDecimal** | All depreciation prior to the current financial year. | [optional] 
+**current_accum_depreciation_amount** | **BigDecimal** | All depreciation occurring in the current financial year. | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::BookDepreciationDetail.new(current_capital_gain: 5.25,
+                                 current_gain_loss: 10.5,
+                                 depreciation_start_date: null,
+                                 cost_limit: 9000.0,
+                                 residual_value: 10000.0,
+                                 prior_accum_depreciation_amount: 0.45,
+                                 current_accum_depreciation_amount: 5.0)
+```
+
+

data/docs/assets/BookDepreciationSetting.md

@@ -0,0 +1,31 @@
+# XeroRuby::Assets::BookDepreciationSetting
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**depreciation_method** | **String** | The method of depreciation applied to this asset. See Depreciation Methods | [optional] 
+**averaging_method** | **String** | The method of averaging applied to this asset. See Averaging Methods | [optional] 
+**depreciation_rate** | **BigDecimal** | The rate of depreciation (e.g. 0.05) | [optional] 
+**effective_life_years** | **Integer** | Effective life of the asset in years (e.g. 5) | [optional] 
+**depreciation_calculation_method** | **String** | See Depreciation Calculation Methods | [optional] 
+**depreciable_object_id** | **String** | Unique Xero identifier for the depreciable object | [optional] 
+**depreciable_object_type** | **String** | The type of asset object | [optional] 
+**book_effective_date_of_change_id** | **String** | Unique Xero identifier for the effective date change | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::BookDepreciationSetting.new(depreciation_method: StraightLine,
+                                 averaging_method: ActualDays,
+                                 depreciation_rate: 0.05,
+                                 effective_life_years: 5,
+                                 depreciation_calculation_method: None,
+                                 depreciable_object_id: 68f17094-af97-4f1b-b36b-013b45b6ad3c,
+                                 depreciable_object_type: Asset,
+                                 book_effective_date_of_change_id: 68f17094-af97-4f1b-b36b-013b45b6ad3c)
+```
+
+

data/docs/assets/Error.md

@@ -0,0 +1,25 @@
+# XeroRuby::Assets::Error
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**resource_validation_errors** | [**Array<ResourceValidationErrorsElement>**](ResourceValidationErrorsElement.md) | Array of elements of resource validation errors | [optional] 
+**field_validation_errors** | [**Array<FieldValidationErrorsElement>**](FieldValidationErrorsElement.md) | Array of elements of field validation errors | [optional] 
+**type** | **String** | The internal type of error, not accessible externally | [optional] 
+**title** | **String** | Title of the error | [optional] 
+**detail** | **String** | Detail of the error | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::Error.new(resource_validation_errors: null,
+                                 field_validation_errors: null,
+                                 type: null,
+                                 title: null,
+                                 detail: null)
+```
+
+

data/docs/assets/FieldValidationErrorsElement.md

@@ -0,0 +1,27 @@
+# XeroRuby::Assets::FieldValidationErrorsElement
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**field_name** | **String** | The field name of the erroneous field | [optional] 
+**value_provided** | **String** | The provided value | [optional] 
+**localised_message** | **String** | Explaination of the field validation error | [optional] 
+**type** | **String** | Internal type of the field validation error message | [optional] 
+**title** | **String** | Title of the field validation error | [optional] 
+**detail** | **String** | Detail of the field validation error | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::FieldValidationErrorsElement.new(field_name: null,
+                                 value_provided: null,
+                                 localised_message: null,
+                                 type: null,
+                                 title: null,
+                                 detail: null)
+```
+
+

data/docs/assets/Pagination.md

@@ -0,0 +1,23 @@
+# XeroRuby::Assets::Pagination
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**page** | **Integer** |  | [optional] 
+**page_size** | **Integer** |  | [optional] 
+**page_count** | **Integer** |  | [optional] 
+**item_count** | **Integer** |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::Pagination.new(page: 1,
+                                 page_size: 10,
+                                 page_count: 1,
+                                 item_count: 2)
+```
+
+

data/docs/assets/ResourceValidationErrorsElement.md

@@ -0,0 +1,25 @@
+# XeroRuby::Assets::ResourceValidationErrorsElement
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**resource_name** | **String** | The field name of the erroneous field | [optional] 
+**localised_message** | **String** | Explaination of the resource validation error | [optional] 
+**type** | **String** | Internal type of the resource error message | [optional] 
+**title** | **String** | Title of the resource validation error | [optional] 
+**detail** | **String** | Detail of the resource validation error | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::ResourceValidationErrorsElement.new(resource_name: null,
+                                 localised_message: null,
+                                 type: null,
+                                 title: null,
+                                 detail: null)
+```
+
+

data/docs/assets/Setting.md

@@ -0,0 +1,31 @@
+# XeroRuby::Assets::Setting
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**asset_number_prefix** | **String** | The prefix used for fixed asset numbers (“FA-” by default) | [optional] 
+**asset_number_sequence** | **String** | The next available sequence number | [optional] 
+**asset_start_date** | **Date** | The date depreciation calculations started on registered fixed assets in Xero | [optional] 
+**last_depreciation_date** | **Date** | The last depreciation date | [optional] 
+**default_gain_on_disposal_account_id** | **String** | Default account that gains are posted to | [optional] 
+**default_loss_on_disposal_account_id** | **String** | Default account that losses are posted to | [optional] 
+**default_capital_gain_on_disposal_account_id** | **String** | Default account that capital gains are posted to | [optional] 
+**opt_in_for_tax** | **Boolean** | opt in for tax calculation | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Assets'
+
+instance = XeroRuby::Assets::Setting.new(asset_number_prefix: FA-,
+                                 asset_number_sequence: 0022,
+                                 asset_start_date: null,
+                                 last_depreciation_date: null,
+                                 default_gain_on_disposal_account_id: 346ddb97-739a-4274-b43b-66aa3218d17c,
+                                 default_loss_on_disposal_account_id: 1b798541-24e2-4855-9309-c023a0b576f3,
+                                 default_capital_gain_on_disposal_account_id: 6d6a0bdb-e118-45d8-a023-2ad617ec1cb7,
+                                 opt_in_for_tax: false)
+```
+
+

data/docs/files/Association.md

@@ -0,0 +1,23 @@
+# XeroRuby::Files::Association
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**file_id** | **String** | The unique identifier of the file | [optional] 
+**object_id** | **String** | The identifier of the object that the file is being associated with (e.g. InvoiceID, BankTransactionID, ContactID) | [optional] 
+**object_group** | [**ObjectGroup**](ObjectGroup.md) |  | [optional] 
+**object_type** | [**ObjectType**](ObjectType.md) |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Files'
+
+instance = XeroRuby::Files::Association.new(file_id: null,
+                                 object_id: null,
+                                 object_group: null,
+                                 object_type: null)
+```
+
+

data/docs/files/FileObject.md

@@ -0,0 +1,31 @@
+# XeroRuby::Files::FileObject
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**name** | **String** | File Name | [optional] 
+**mime_type** | **String** | MimeType of the file (image/png, image/jpeg, application/pdf, etc..) | [optional] 
+**size** | **Integer** | Numeric value in bytes | [optional] 
+**created_date_utc** | **String** | Created date in UTC | [optional] 
+**updated_date_utc** | **String** | Updated date in UTC | [optional] 
+**user** | [**User**](User.md) |  | [optional] 
+**id** | **String** | File object's UUID | [optional] 
+**folder_id** | **String** | Folder relation object's UUID | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Files'
+
+instance = XeroRuby::Files::FileObject.new(name: File2.jpg,
+                                 mime_type: image/jpeg,
+                                 size: 3615,
+                                 created_date_utc: 2020-12-03T19:04:58.6970000,
+                                 updated_date_utc: 2020-12-03T19:04:58.6970000,
+                                 user: null,
+                                 id: d290f1ee-6c54-4b01-90e6-d701748f0851,
+                                 folder_id: 0f8ccf21-7267-4268-9167-a1e2c40c84c8)
+```
+
+

data/docs/files/FileResponse204.md

@@ -0,0 +1,17 @@
+# XeroRuby::Files::FileResponse204
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**status** | **String** | Status response for 204 no content | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Files'
+
+instance = XeroRuby::Files::FileResponse204.new(status: null)
+```
+
+

data/docs/files/Files.md

@@ -0,0 +1,23 @@
+# XeroRuby::Files::Files
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**total_count** | **Integer** |  | [optional] 
+**page** | **Integer** |  | [optional] 
+**per_page** | **Integer** |  | [optional] 
+**items** | [**Array<FileObject>**](FileObject.md) |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'XeroRuby::Files'
+
+instance = XeroRuby::Files::Files.new(total_count: 2,
+                                 page: 1,
+                                 per_page: 50,
+                                 items: null)
+```
+
+

data/docs/files/FilesApi.md

@@ -0,0 +1,1116 @@
+# XeroRuby::Files::FilesApi
+
+All URIs are relative to *https://api.xero.com/files.xro/1.0*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**create_file_association**](FilesApi.md#create_file_association) | **POST** /Files/{FileId}/Associations | create a new association
+[**create_folder**](FilesApi.md#create_folder) | **POST** /Folders | create a new folder
+[**delete_file**](FilesApi.md#delete_file) | **DELETE** /Files/{FileId} | delete a file
+[**delete_file_association**](FilesApi.md#delete_file_association) | **DELETE** /Files/{FileId}/Associations/{ObjectId} | create a new association
+[**delete_folder**](FilesApi.md#delete_folder) | **DELETE** /Folders/{FolderId} | delete a folder
+[**get_associations_by_object**](FilesApi.md#get_associations_by_object) | **GET** /Associations/{ObjectId} | searches files
+[**get_file**](FilesApi.md#get_file) | **GET** /Files/{FileId} | searches for file by unique id
+[**get_file_associations**](FilesApi.md#get_file_associations) | **GET** /Files/{FileId}/Associations | searches files
+[**get_file_content**](FilesApi.md#get_file_content) | **GET** /Files/{FileId}/Content | searches files to retrieve the data
+[**get_files**](FilesApi.md#get_files) | **GET** /Files | searches files
+[**get_folder**](FilesApi.md#get_folder) | **GET** /Folders/{FolderId} | searches specific folder by id
+[**get_folders**](FilesApi.md#get_folders) | **GET** /Folders | searches folder
+[**get_inbox**](FilesApi.md#get_inbox) | **GET** /Inbox | searches inbox folder
+[**update_file**](FilesApi.md#update_file) | **PUT** /Files/{FileId} | Update a file
+[**update_folder**](FilesApi.md#update_folder) | **PUT** /Folders/{FolderId} | update folder
+[**upload_file**](FilesApi.md#upload_file) | **POST** /Files | upload an File
+
+
+
+## create_file_association
+
+> Association create_file_association(xero_tenant_id, file_id, opts)
+
+create a new association
+
+By passing in the appropriate options, you can create a new folder
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+file_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | File id for single object
+opts = {
+  association: XeroRuby::Files::Association.new # Association | 
+}
+
+begin
+  #create a new association
+  result = api_instance.create_file_association(xero_tenant_id, file_id, opts)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->create_file_association: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **file_id** | [**String**](.md)| File id for single object | 
+ **association** | [**Association**](Association.md)|  | [optional] 
+
+### Return type
+
+[**Association**](Association.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_folder
+
+> Folder create_folder(xero_tenant_id, opts)
+
+create a new folder
+
+By passing in the appropriate properties, you can create a new folder
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+opts = {
+  folder: XeroRuby::Files::Folder.new # Folder | 
+}
+
+begin
+  #create a new folder
+  result = api_instance.create_folder(xero_tenant_id, opts)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->create_folder: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **folder** | [**Folder**](Folder.md)|  | [optional] 
+
+### Return type
+
+[**Folder**](Folder.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## delete_file
+
+> FileResponse204 delete_file(xero_tenant_id, file_id)
+
+delete a file
+
+Delete a specific file
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+file_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | File id for single object
+begin
+  #delete a file
+  result = api_instance.delete_file(xero_tenant_id, file_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->delete_file: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **file_id** | [**String**](.md)| File id for single object | 
+
+### Return type
+
+[**FileResponse204**](FileResponse204.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## delete_file_association
+
+> FileResponse204 delete_file_association(xero_tenant_id, file_id, object_id)
+
+create a new association
+
+By passing in the appropriate options, you can create a new folder
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+file_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | File id for single object
+object_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | Object id for single object
+begin
+  #create a new association
+  result = api_instance.delete_file_association(xero_tenant_id, file_id, object_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->delete_file_association: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **file_id** | [**String**](.md)| File id for single object | 
+ **object_id** | [**String**](.md)| Object id for single object | 
+
+### Return type
+
+[**FileResponse204**](FileResponse204.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## delete_folder
+
+> FileResponse204 delete_folder(xero_tenant_id, folder_id)
+
+delete a folder
+
+By passing in the appropriate ID, you can delete a folder
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+folder_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | Folder id for single object
+begin
+  #delete a folder
+  result = api_instance.delete_folder(xero_tenant_id, folder_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->delete_folder: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **folder_id** | [**String**](.md)| Folder id for single object | 
+
+### Return type
+
+[**FileResponse204**](FileResponse204.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_associations_by_object
+
+> Array&lt;Association&gt; get_associations_by_object(xero_tenant_id, object_id)
+
+searches files
+
+By passing in the appropriate options,
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+object_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | Object id for single object
+begin
+  #searches files
+  result = api_instance.get_associations_by_object(xero_tenant_id, object_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_associations_by_object: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **object_id** | [**String**](.md)| Object id for single object | 
+
+### Return type
+
+[**Array&lt;Association&gt;**](Association.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_file
+
+> FileObject get_file(xero_tenant_id, file_id)
+
+searches for file by unique id
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+file_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | File id for single object
+begin
+  #searches for file by unique id
+  result = api_instance.get_file(xero_tenant_id, file_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_file: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **file_id** | [**String**](.md)| File id for single object | 
+
+### Return type
+
+[**FileObject**](FileObject.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_file_associations
+
+> Array&lt;Association&gt; get_file_associations(xero_tenant_id, file_id)
+
+searches files
+
+By passing in the appropriate options,  
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+file_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | File id for single object
+begin
+  #searches files
+  result = api_instance.get_file_associations(xero_tenant_id, file_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_file_associations: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **file_id** | [**String**](.md)| File id for single object | 
+
+### Return type
+
+[**Array&lt;Association&gt;**](Association.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_file_content
+
+> File get_file_content(xero_tenant_id, file_id)
+
+searches files to retrieve the data
+
+By passing in the appropriate options, retrieve data for specific file
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+file_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | File id for single object
+begin
+  #searches files to retrieve the data
+  result = api_instance.get_file_content(xero_tenant_id, file_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_file_content: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **file_id** | [**String**](.md)| File id for single object | 
+
+### Return type
+
+**File**
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/octet-stream
+
+
+## get_files
+
+> Files get_files(xero_tenant_id, opts)
+
+searches files
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+opts = {
+  pagesize: 50, # Integer | pass an optional page size value
+
+  page: 2, # Integer | number of records to skip for pagination
+
+  sort: 'CreatedDateUTC DESC' # String | values to sort by
+}
+
+begin
+  #searches files
+  result = api_instance.get_files(xero_tenant_id, opts)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_files: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **pagesize** | **Integer**| pass an optional page size value | [optional] 
+ **page** | **Integer**| number of records to skip for pagination | [optional] 
+ **sort** | **String**| values to sort by | [optional] 
+
+### Return type
+
+[**Files**](Files.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_folder
+
+> Folder get_folder(xero_tenant_id, folder_id)
+
+searches specific folder by id
+
+By passing in the appropriate ID, you can search for specific folder
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+folder_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | Folder id for single object
+begin
+  #searches specific folder by id
+  result = api_instance.get_folder(xero_tenant_id, folder_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_folder: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **folder_id** | [**String**](.md)| Folder id for single object | 
+
+### Return type
+
+[**Folder**](Folder.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_folders
+
+> Array&lt;Folder&gt; get_folders(xero_tenant_id, opts)
+
+searches folder
+
+By passing in the appropriate options, you can search for available folders
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+opts = {
+  sort: 'CreatedDateUTC DESC' # String | values to sort by
+}
+
+begin
+  #searches folder
+  result = api_instance.get_folders(xero_tenant_id, opts)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_folders: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **sort** | **String**| values to sort by | [optional] 
+
+### Return type
+
+[**Array&lt;Folder&gt;**](Folder.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_inbox
+
+> Folder get_inbox(xero_tenant_id)
+
+searches inbox folder
+
+Search for the user inbox
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+begin
+  #searches inbox folder
+  result = api_instance.get_inbox(xero_tenant_id)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->get_inbox: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+
+### Return type
+
+[**Folder**](Folder.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## update_file
+
+> FileObject update_file(xero_tenant_id, file_id, opts)
+
+Update a file
+
+Update properties on a single file
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+file_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | File id for single object
+opts = {
+  file_object: XeroRuby::Files::FileObject.new # FileObject | 
+}
+
+begin
+  #Update a file
+  result = api_instance.update_file(xero_tenant_id, file_id, opts)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->update_file: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **file_id** | [**String**](.md)| File id for single object | 
+ **file_object** | [**FileObject**](FileObject.md)|  | [optional] 
+
+### Return type
+
+[**FileObject**](FileObject.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## update_folder
+
+> Folder update_folder(xero_tenant_id, folder_id, folder)
+
+update folder
+
+By passing in the appropriate ID and properties, you can update a folder
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+folder_id = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c' # String | Folder id for single object
+folder = XeroRuby::Files::Folder.new # Folder | 
+begin
+  #update folder
+  result = api_instance.update_folder(xero_tenant_id, folder_id, folder)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->update_folder: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **folder_id** | [**String**](.md)| Folder id for single object | 
+ **folder** | [**Folder**](Folder.md)|  | 
+
+### Return type
+
+[**Folder**](Folder.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## upload_file
+
+> FileObject upload_file(xero_tenant_id, opts)
+
+upload an File
+
+### Example
+
+```ruby
+# load the gem
+require 'xero-ruby'
+
+creds = {
+  client_id: ENV['CLIENT_ID'],
+  client_secret: ENV['CLIENT_SECRET'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scopes: ENV['SCOPES']
+}
+xero_client = XeroRuby::ApiClient.new(credentials: creds)
+
+token_set = fetch_valid_token_set(user) # example
+
+xero_client.refresh_token_set(token_set)
+
+# You need to namespace your api method call to one of the following api sets
+# [:accounting_api, :assets_api, :projects_api, :files_api, :payroll_au_api, :payroll_nz_api, :payroll_uk_api]
+
+api_instance = xero_client.<api_set>
+
+
+
+xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
+opts = {
+  folder_id: '4ff1e5cc-9835-40d5-bb18-09fdb118db9c', # String | pass an optional folder id to save file to specific folder
+
+  body: 'body_example', # String | 
+
+  name: 'name_example', # String | exact name of the file you are uploading
+
+  filename: 'filename_example', # String | 
+
+  mime_type: 'mime_type_example' # String | 
+}
+
+begin
+  #upload an File
+  result = api_instance.upload_file(xero_tenant_id, opts)
+  p result
+rescue XeroRuby::Files::ApiError => e
+  puts "Exception when calling FilesApi->upload_file: #{e}"
+end
+```
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **xero_tenant_id** | **String**| Xero identifier for Tenant | 
+ **folder_id** | [**String**](.md)| pass an optional folder id to save file to specific folder | [optional] 
+ **body** | **String**|  | [optional] 
+ **name** | **String**| exact name of the file you are uploading | [optional] 
+ **filename** | **String**|  | [optional] 
+ **mime_type** | **String**|  | [optional] 
+
+### Return type
+
+[**FileObject**](FileObject.md)
+
+### Authorization
+
+[OAuth2](../README.md#OAuth2)
+
+### HTTP request headers
+
+- **Content-Type**: multipart/form-data
+- **Accept**: application/json
+