ynab 1.4.0 → 1.5.0

data/docs/TransactionDetail.md

@@ -13,7 +13,8 @@ Name | Type | Description | Notes
 **account_id** | **String** |  | 
 **payee_id** | **String** |  | 
 **category_id** | **String** |  | 
-**transfer_account_id** | **String** |  | 
+**transfer_account_id** | **String** | If a transfer transaction, the account to which it transfers | 
+**transfer_transaction_id** | **String** | If a transfer transaction, the id of transaction on the other side of the transfer | 
 **import_id** | **String** | If the Transaction was imported, this field is a unique (by account) import identifier.  If this transaction was imported through File Based Import or Direct Import and not through the API, the import_id will have the format: 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]'.  For example, a transaction dated 2015-12-30 in the amount of -$294.23 USD would have an import_id of 'YNAB:-294230:2015-12-30:1'.  If a second transaction on the same account was imported and had the same date and same amount, its import_id would be 'YNAB:-294230:2015-12-30:2'. | 
 **deleted** | **BOOLEAN** | Whether or not the transaction has been deleted.  Deleted transactions will only be included in delta requests. | 
 **account_name** | **String** |  | 

data/docs/TransactionSummary.md

@@ -13,7 +13,8 @@ Name | Type | Description | Notes
 **account_id** | **String** |  | 
 **payee_id** | **String** |  | 
 **category_id** | **String** |  | 
-**transfer_account_id** | **String** |  | 
+**transfer_account_id** | **String** | If a transfer transaction, the account to which it transfers | 
+**transfer_transaction_id** | **String** | If a transfer transaction, the id of transaction on the other side of the transfer | 
 **import_id** | **String** | If the Transaction was imported, this field is a unique (by account) import identifier.  If this transaction was imported through File Based Import or Direct Import and not through the API, the import_id will have the format: 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]'.  For example, a transaction dated 2015-12-30 in the amount of -$294.23 USD would have an import_id of 'YNAB:-294230:2015-12-30:1'.  If a second transaction on the same account was imported and had the same date and same amount, its import_id would be 'YNAB:-294230:2015-12-30:2'. | 
 **deleted** | **BOOLEAN** | Whether or not the transaction has been deleted.  Deleted transactions will only be included in delta requests. | 
 

data/docs/TransactionsApi.md

@@ -5,7 +5,7 @@ All URIs are relative to *https://api.youneedabudget.com/v1*
 Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**bulk_create_transactions**](TransactionsApi.md#bulk_create_transactions) | **POST** /budgets/{budget_id}/transactions/bulk | Bulk create transactions
-[**create_transaction**](TransactionsApi.md#create_transaction) | **POST** /budgets/{budget_id}/transactions | Create new transaction
+[**create_transaction**](TransactionsApi.md#create_transaction) | **POST** /budgets/{budget_id}/transactions | Create a single transaction or multiple transactions
 [**get_transaction_by_id**](TransactionsApi.md#get_transaction_by_id) | **GET** /budgets/{budget_id}/transactions/{transaction_id} | Single transaction
 [**get_transactions**](TransactionsApi.md#get_transactions) | **GET** /budgets/{budget_id}/transactions | List transactions
 [**get_transactions_by_account**](TransactionsApi.md#get_transactions_by_account) | **GET** /budgets/{budget_id}/accounts/{account_id}/transactions | List account transactions
@@ -25,30 +25,30 @@ Creates multiple transactions
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **transactions** | [**BulkTransactions**](BulkTransactions.md)| The list of Transactions to create. | 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **transactions** | [**BulkTransactions**](BulkTransactions.md)| The list of transactions to create | 
 
 ### Return type
 
 [**BulkResponse**](BulkResponse.md)
 
 # **create_transaction**
-> TransactionResponse create_transaction(budget_id, transaction)
+> SaveTransactionsResponse create_transaction(budget_id, save_transactions)
 
-Create new transaction
+Create a single transaction or multiple transactions
 
-Creates a transaction
+Creates a single transaction or multiple transactions.  If you provide a body containing a 'transaction' object, a single transaction will be created and if you provide a body containing a 'transactions' array, multiple transactions will be created.
 
 ### Parameters
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **transaction** | [**SaveTransactionWrapper**](SaveTransactionWrapper.md)| The Transaction to create. | 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **save_transactions** | [**SaveTransactionsWrapper**](SaveTransactionsWrapper.md)| The transaction or transactions to create | 
 
 ### Return type
 
-[**TransactionResponse**](TransactionResponse.md)
+[**SaveTransactionsResponse**](SaveTransactionsResponse.md)
 
 # **get_transaction_by_id**
 > TransactionResponse get_transaction_by_id(budget_id, transaction_id)
@@ -61,8 +61,8 @@ Returns a single transaction
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **transaction_id** | [**String**](.md)| The ID of the Transaction. | 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **transaction_id** | [**String**](.md)| The id of the transaction | 
 
 ### Return type
 
@@ -79,8 +79,8 @@ Returns budget transactions
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **since_date** | **Date**| Only return transactions on or after this date. | [optional] 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **since_date** | **Date**| Only return transactions on or after this date | [optional] 
  **type** | **String**| Only return transactions of a certain type ('uncategorized' and 'unapproved' are currently supported) | [optional] 
 
 ### Return type
@@ -98,9 +98,9 @@ Returns all transactions for a specified account
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **account_id** | [**String**](.md)| The ID of the Account. | 
- **since_date** | **Date**| Only return transactions on or after this date. | [optional] 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **account_id** | [**String**](.md)| The id of the account | 
+ **since_date** | **Date**| Only return transactions on or after this date | [optional] 
  **type** | **String**| Only return transactions of a certain type (i.e. 'uncategorized', 'unapproved') | [optional] 
 
 ### Return type
@@ -118,9 +118,9 @@ Returns all transactions for a specified category
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **category_id** | [**String**](.md)| The ID of the Category. | 
- **since_date** | **Date**| Only return transactions on or after this date. | [optional] 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **category_id** | [**String**](.md)| The id of the category | 
+ **since_date** | **Date**| Only return transactions on or after this date | [optional] 
  **type** | **String**| Only return transactions of a certain type (i.e. 'uncategorized', 'unapproved') | [optional] 
 
 ### Return type
@@ -138,9 +138,9 @@ Returns all transactions for a specified payee
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **payee_id** | [**String**](.md)| The ID of the Payee. | 
- **since_date** | **Date**| Only return transactions on or after this date. | [optional] 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **payee_id** | [**String**](.md)| The id of the payee | 
+ **since_date** | **Date**| Only return transactions on or after this date | [optional] 
  **type** | **String**| Only return transactions of a certain type (i.e. 'uncategorized', 'unapproved') | [optional] 
 
 ### Return type
@@ -158,9 +158,9 @@ Updates a transaction
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **budget_id** | [**String**](.md)| The ID of the Budget.  \"last-used\" can also be used to specify the last used budget. | 
- **transaction_id** | [**String**](.md)| The ID of the Transaction. | 
- **transaction** | [**SaveTransactionWrapper**](SaveTransactionWrapper.md)| The Transaction to update. | 
+ **budget_id** | [**String**](.md)| The id of the budget (\"last-used\" can also be used to specify the last used budget) | 
+ **transaction_id** | [**String**](.md)| The id of the transaction | 
+ **transaction** | [**SaveTransactionWrapper**](SaveTransactionWrapper.md)| The transaction to update | 
 
 ### Return type
 

data/docs/UserApi.md

@@ -12,7 +12,7 @@ Method | HTTP request | Description
 
 User info
 
-Returns authenticated user information.
+Returns authenticated user information
 
 ### Parameters
 This endpoint does not need any parameter.

data/examples/create-multiple-transactions.rb

@@ -0,0 +1,44 @@
+require 'date'
+require 'ynab'
+
+def create_multiple_transactions
+  access_token = 'bf0cbb14b4330-not-real-3de12e66a389eaafe2'
+  ynab = YNAB::API.new(access_token)
+
+  budget_id = 'f968197b-2863-not-real-c2406dbe7f0d'
+  account_id = 'f6fe07cb-c895-not-real-acfac0b7f026'
+  category_id = 'a191ac84-de09-not-real-6c5ed8cfdabe'
+
+  begin
+    ynab.transactions.create_transaction(budget_id, {
+      transactions: [
+        {
+          account_id: account_id,
+          category_id: category_id,
+          date: Date.today,
+          payee_name: 'A Test Payee',
+          memo: 'I was created through the API',
+          cleared: 'Cleared',
+          approved: true,
+          flag_color: 'Blue',
+          amount: 20000
+       },
+       {
+          account_id: account_id,
+          category_id: category_id,
+          date: Date.today,
+          payee_name: 'Another Test Payee',
+          memo: 'I was also created through the API',
+          cleared: 'Uncleared',
+          approved: false,
+          flag_color: 'Red',
+          amount: 39453
+       }
+      ]
+    })
+  rescue => e
+    puts "ERROR: id=#{e.id}; name=#{e.name}; detail: #{e.detail}"
+  end
+end
+
+create_multiple_transactions

data/examples/update-category-budgeted.rb

@@ -0,0 +1,23 @@
+require 'date'
+require 'ynab'
+
+def update_category_budgeted
+  access_token = 'bf0cbb14b4330-not-real-3de12e66a389eaafe2'
+  ynab = YNAB::API.new(access_token)
+
+  budget_id = 'f968197b-2863-not-real-c2406dbe7f0d'
+  category_id = 'a191ac84-de09-not-real-6c5ed8cfdabe'
+  month = '2018-09-01'
+  month_category = { budgeted: 20382 }
+
+  begin
+    # Update budgeted amount to 203.82 in 2018-09-01 for category_id
+    response = ynab.categories.update_month_category(budget_id, '2018-09-01', category_id, month_category: month_category)
+    month_category_response = response.data.category
+    puts "[budgeted: #{month_category_response.budgeted}, balance: #{month_category_response.balance}]"
+  rescue => e
+    puts "ERROR: id=#{e.id}; name=#{e.name}; detail: #{e.detail}"
+  end
+end
+
+update_category_budgeted

data/lib/ynab.rb

@@ -61,8 +61,13 @@ require 'ynab/models/payee_response'
 require 'ynab/models/payee_wrapper'
 require 'ynab/models/payees_response'
 require 'ynab/models/payees_wrapper'
+require 'ynab/models/save_month_category'
+require 'ynab/models/save_month_category_wrapper'
 require 'ynab/models/save_transaction'
 require 'ynab/models/save_transaction_wrapper'
+require 'ynab/models/save_transactions_response'
+require 'ynab/models/save_transactions_response_data'
+require 'ynab/models/save_transactions_wrapper'
 require 'ynab/models/scheduled_sub_transaction'
 require 'ynab/models/scheduled_transaction_response'
 require 'ynab/models/scheduled_transaction_summary'

data/lib/ynab/api/accounts_api.rb

@@ -21,8 +21,8 @@ module YNAB
     end
     # Single account
     # Returns a single account
-    # @param budget_id The ID of the Budget.  \"last-used\" can also be used to specify the last used budget.
-    # @param account_id The ID of the Account.
+    # @param budget_id The id of the budget (\"last-used\" can also be used to specify the last used budget)
+    # @param account_id The id of the account
     # @param [Hash] opts the optional parameters
     # @return [AccountResponse]
     def get_account_by_id(budget_id, account_id, opts = {})
@@ -32,8 +32,8 @@ module YNAB
 
     # Single account
     # Returns a single account
-    # @param budget_id The ID of the Budget.  \"last-used\" can also be used to specify the last used budget.
-    # @param account_id The ID of the Account.
+    # @param budget_id The id of the budget (\"last-used\" can also be used to specify the last used budget)
+    # @param account_id The id of the account
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountResponse, Fixnum, Hash)>] AccountResponse data, response status code and response headers
     def get_account_by_id_with_http_info(budget_id, account_id, opts = {})
@@ -79,7 +79,7 @@ module YNAB
     end
     # Account list
     # Returns all accounts
-    # @param budget_id The ID of the Budget.  \&quot;last-used\&quot; can also be used to specify the last used budget.
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @return [AccountsResponse]
     def get_accounts(budget_id, opts = {})
@@ -89,7 +89,7 @@ module YNAB
 
     # Account list
     # Returns all accounts
-    # @param budget_id The ID of the Budget.  \&quot;last-used\&quot; can also be used to specify the last used budget.
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountsResponse, Fixnum, Hash)>] AccountsResponse data, response status code and response headers
     def get_accounts_with_http_info(budget_id, opts = {})

data/lib/ynab/api/budgets_api.rb

@@ -21,7 +21,7 @@ module YNAB
     end
     # Single budget
     # Returns a single budget with all related entities.  This resource is effectively a full budget export.
-    # @param budget_id The ID of the Budget.  \"last-used\" can also be used to specify the last used budget.
+    # @param budget_id The id of the budget (\"last-used\" can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :last_knowledge_of_server The starting server knowledge.  If provided, only entities that have changed since last_knowledge_of_server will be included.
     # @return [BudgetDetailResponse]
@@ -32,7 +32,7 @@ module YNAB
 
     # Single budget
     # Returns a single budget with all related entities.  This resource is effectively a full budget export.
-    # @param budget_id The ID of the Budget.  \"last-used\" can also be used to specify the last used budget.
+    # @param budget_id The id of the budget (\"last-used\" can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :last_knowledge_of_server The starting server knowledge.  If provided, only entities that have changed since last_knowledge_of_server will be included.
     # @return [Array<(BudgetDetailResponse, Fixnum, Hash)>] BudgetDetailResponse data, response status code and response headers
@@ -75,8 +75,8 @@ module YNAB
       return data, status_code, headers
     end
     # Budget Settings
-    # Returns settings for a budget.
-    # @param budget_id The ID of the Budget.  \&quot;last-used\&quot; can also be used to specify the last used budget.
+    # Returns settings for a budget
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @return [BudgetSettingsResponse]
     def get_budget_settings_by_id(budget_id, opts = {})
@@ -85,8 +85,8 @@ module YNAB
     end
 
     # Budget Settings
-    # Returns settings for a budget.
-    # @param budget_id The ID of the Budget.  \&quot;last-used\&quot; can also be used to specify the last used budget.
+    # Returns settings for a budget
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @return [Array<(BudgetSettingsResponse, Fixnum, Hash)>] BudgetSettingsResponse data, response status code and response headers
     def get_budget_settings_by_id_with_http_info(budget_id, opts = {})
@@ -127,7 +127,7 @@ module YNAB
       return data, status_code, headers
     end
     # List budgets
-    # Returns budgets list with summary information.
+    # Returns budgets list with summary information
     # @param [Hash] opts the optional parameters
     # @return [BudgetSummaryResponse]
     def get_budgets(opts = {})
@@ -136,7 +136,7 @@ module YNAB
     end
 
     # List budgets
-    # Returns budgets list with summary information.
+    # Returns budgets list with summary information
     # @param [Hash] opts the optional parameters
     # @return [Array<(BudgetSummaryResponse, Fixnum, Hash)>] BudgetSummaryResponse data, response status code and response headers
     def get_budgets_with_http_info(opts = {})

data/lib/ynab/api/categories_api.rb

@@ -20,8 +20,8 @@ module YNAB
       @api_client = api_client
     end
     # List categories
-    # Returns all categories grouped by category group.
-    # @param budget_id The ID of the Budget.  \"last-used\" can also be used to specify the last used budget.
+    # Returns all categories grouped by category group
+    # @param budget_id The id of the budget (\"last-used\" can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @return [CategoriesResponse]
     def get_categories(budget_id, opts = {})
@@ -30,8 +30,8 @@ module YNAB
     end
 
     # List categories
-    # Returns all categories grouped by category group.
-    # @param budget_id The ID of the Budget.  \"last-used\" can also be used to specify the last used budget.
+    # Returns all categories grouped by category group
+    # @param budget_id The id of the budget (\"last-used\" can also be used to specify the last used budget)
     # @param [Hash] opts the optional parameters
     # @return [Array<(CategoriesResponse, Fixnum, Hash)>] CategoriesResponse data, response status code and response headers
     def get_categories_with_http_info(budget_id, opts = {})
@@ -73,8 +73,8 @@ module YNAB
     end
     # Single category
     # Returns a single category
-    # @param budget_id The ID of the Budget.  \&quot;last-used\&quot; can also be used to specify the last used budget.
-    # @param category_id The ID of the Category.
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
+    # @param category_id The id of the category
     # @param [Hash] opts the optional parameters
     # @return [CategoryResponse]
     def get_category_by_id(budget_id, category_id, opts = {})
@@ -84,8 +84,8 @@ module YNAB
 
     # Single category
     # Returns a single category
-    # @param budget_id The ID of the Budget.  \&quot;last-used\&quot; can also be used to specify the last used budget.
-    # @param category_id The ID of the Category.
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
+    # @param category_id The id of the category
     # @param [Hash] opts the optional parameters
     # @return [Array<(CategoryResponse, Fixnum, Hash)>] CategoryResponse data, response status code and response headers
     def get_category_by_id_with_http_info(budget_id, category_id, opts = {})
@@ -129,5 +129,139 @@ module YNAB
       end
       return data, status_code, headers
     end
+    # Single category for a specific budget month
+    # Returns a single category for a specific budget month
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
+    # @param month the budget month in ISO format (e.g. 2016-12-30). (\&quot;current\&quot; can also be used to specify the current calendar month (UTC))
+    # @param category_id The id of the category
+    # @param [Hash] opts the optional parameters
+    # @return [CategoryResponse]
+    def get_month_category_by_id(budget_id, month, category_id, opts = {})
+      data, _status_code, _headers = get_month_category_by_id_with_http_info(budget_id, month, category_id, opts)
+      data
+    end
+
+    # Single category for a specific budget month
+    # Returns a single category for a specific budget month
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
+    # @param month the budget month in ISO format (e.g. 2016-12-30). (\&quot;current\&quot; can also be used to specify the current calendar month (UTC))
+    # @param category_id The id of the category
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CategoryResponse, Fixnum, Hash)>] CategoryResponse data, response status code and response headers
+    def get_month_category_by_id_with_http_info(budget_id, month, category_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CategoriesApi.get_month_category_by_id ...'
+      end
+      # verify the required parameter 'budget_id' is set
+      if @api_client.config.client_side_validation && budget_id.nil?
+        fail ArgumentError, "Missing the required parameter 'budget_id' when calling CategoriesApi.get_month_category_by_id"
+      end
+      # verify the required parameter 'month' is set
+      if @api_client.config.client_side_validation && month.nil?
+        fail ArgumentError, "Missing the required parameter 'month' when calling CategoriesApi.get_month_category_by_id"
+      end
+      # verify the required parameter 'category_id' is set
+      if @api_client.config.client_side_validation && category_id.nil?
+        fail ArgumentError, "Missing the required parameter 'category_id' when calling CategoriesApi.get_month_category_by_id"
+      end
+      # resource path
+      local_var_path = '/budgets/{budget_id}/months/{month}/categories/{category_id}'.sub('{' + 'budget_id' + '}', budget_id.to_s).sub('{' + 'month' + '}', month.to_s).sub('{' + 'category_id' + '}', category_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+      auth_names = ['bearer']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'CategoryResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CategoriesApi#get_month_category_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+    # Update an existing month category
+    # Update an existing month category
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
+    # @param month the budget month in ISO format (e.g. 2016-12-01).  \&quot;current\&quot; can also be used to specify the current calendar month (UTC).
+    # @param category_id The id of the category
+    # @param month_category The month category to update
+    # @param [Hash] opts the optional parameters
+    # @return [CategoryResponse]
+    def update_month_category(budget_id, month, category_id, month_category, opts = {})
+      data, _status_code, _headers = update_month_category_with_http_info(budget_id, month, category_id, month_category, opts)
+      data
+    end
+
+    # Update an existing month category
+    # Update an existing month category
+    # @param budget_id The id of the budget (\&quot;last-used\&quot; can also be used to specify the last used budget)
+    # @param month the budget month in ISO format (e.g. 2016-12-01).  \&quot;current\&quot; can also be used to specify the current calendar month (UTC).
+    # @param category_id The id of the category
+    # @param month_category The month category to update
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CategoryResponse, Fixnum, Hash)>] CategoryResponse data, response status code and response headers
+    def update_month_category_with_http_info(budget_id, month, category_id, month_category, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CategoriesApi.update_month_category ...'
+      end
+      # verify the required parameter 'budget_id' is set
+      if @api_client.config.client_side_validation && budget_id.nil?
+        fail ArgumentError, "Missing the required parameter 'budget_id' when calling CategoriesApi.update_month_category"
+      end
+      # verify the required parameter 'month' is set
+      if @api_client.config.client_side_validation && month.nil?
+        fail ArgumentError, "Missing the required parameter 'month' when calling CategoriesApi.update_month_category"
+      end
+      # verify the required parameter 'category_id' is set
+      if @api_client.config.client_side_validation && category_id.nil?
+        fail ArgumentError, "Missing the required parameter 'category_id' when calling CategoriesApi.update_month_category"
+      end
+      # verify the required parameter 'month_category' is set
+      if @api_client.config.client_side_validation && month_category.nil?
+        fail ArgumentError, "Missing the required parameter 'month_category' when calling CategoriesApi.update_month_category"
+      end
+      # resource path
+      local_var_path = '/budgets/{budget_id}/months/{month}/categories/{category_id}'.sub('{' + 'budget_id' + '}', budget_id.to_s).sub('{' + 'month' + '}', month.to_s).sub('{' + 'category_id' + '}', category_id.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(month_category)
+      auth_names = ['bearer']
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'CategoryResponse')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CategoriesApi#update_month_category\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end