mx-platform-ruby 1.10.0 → 1.10.1

data/lib/mx-platform-ruby/api/budgets_api.rb

@@ -1,9 +1,9 @@
 =begin
 #MX Platform API
 
-#The MX Platform API is a powerful, fully-featured API designed to make aggregating and enhancing financial data easy and reliable. It can seamlessly connect your app or website to tens of thousands of financial institutions.
+#The MX Platform API is a powerful, fully-featured API designed to make aggregating and enhancing financial data easy and reliable. It can seamlessly connect your app or website to tens of thousands of financial institutions.  Just getting started? See our [use case guides](/use-cases/). 
 
-The version of the OpenAPI document: 0.1.0
+The version of the OpenAPI document: 20111101
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.8.0
@@ -19,43 +19,39 @@ module MxPlatformRuby
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Delete a budget
-    # Delete a budget.
-    # @param user_guid [String] The unique identifier for the budget. Defined by MX.
-    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
+    # Auto-generate budgets
+    # This endpoint will automatically create budgets for several categories based on existing transactions; these budgets are returned as an array. Specifically, budgets will only be generated if the `user` has at least one `transaction` in a given category during each of the two previous calendar months. For example, if the request is made on March 6, and there is at least one \"Bills & Utilities\" `transaction` in both January and February, a budget will be generated for \"Bills & Utilities.\" If there are two \"Bills & Utilities\" transactions in February but none in January, no budget will be generated for that category. If budgets already exist for particular categories, new budgets will be generated and returned based on the available transactions. If one or more budgets remain unchanged, they will nevertheless be returned in the response. If no transaction data for the `user` meet the above criteria, a `422 Unprocessable Entity` error will be returned with status code 4221 along with the message, `There aren't enough transactions to automatically create any budgets`.
+    # @param user_guid [String] The unique identifier for a `user`, beginning with the prefix `USR-`.
     # @param [Hash] opts the optional parameters
-    # @return [nil]
-    def users_user_guid_budgets_budget_guid_delete(user_guid, budget_guid, opts = {})
-      users_user_guid_budgets_budget_guid_delete_with_http_info(user_guid, budget_guid, opts)
-      nil
+    # @return [BudgetResponseBody]
+    def auto_generate_budgets(user_guid, opts = {})
+      data, _status_code, _headers = auto_generate_budgets_with_http_info(user_guid, opts)
+      data
     end
 
-    # Delete a budget
-    # Delete a budget.
-    # @param user_guid [String] The unique identifier for the budget. Defined by MX.
-    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
+    # Auto-generate budgets
+    # This endpoint will automatically create budgets for several categories based on existing transactions; these budgets are returned as an array. Specifically, budgets will only be generated if the `user` has at least one `transaction` in a given category during each of the two previous calendar months. For example, if the request is made on March 6, and there is at least one \"Bills & Utilities\" `transaction` in both January and February, a budget will be generated for \"Bills & Utilities.\" If there are two \"Bills & Utilities\" transactions in February but none in January, no budget will be generated for that category. If budgets already exist for particular categories, new budgets will be generated and returned based on the available transactions. If one or more budgets remain unchanged, they will nevertheless be returned in the response. If no transaction data for the `user` meet the above criteria, a `422 Unprocessable Entity` error will be returned with status code 4221 along with the message, `There aren't enough transactions to automatically create any budgets`.
+    # @param user_guid [String] The unique identifier for a `user`, beginning with the prefix `USR-`.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def users_user_guid_budgets_budget_guid_delete_with_http_info(user_guid, budget_guid, opts = {})
+    # @return [Array<(BudgetResponseBody, Integer, Hash)>] BudgetResponseBody data, response status code and response headers
+    def auto_generate_budgets_with_http_info(user_guid, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: BudgetsApi.users_user_guid_budgets_budget_guid_delete ...'
+        @api_client.config.logger.debug 'Calling API: BudgetsApi.auto_generate_budgets ...'
       end
       # verify the required parameter 'user_guid' is set
       if @api_client.config.client_side_validation && user_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.users_user_guid_budgets_budget_guid_delete"
-      end
-      # verify the required parameter 'budget_guid' is set
-      if @api_client.config.client_side_validation && budget_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'budget_guid' when calling BudgetsApi.users_user_guid_budgets_budget_guid_delete"
+        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.auto_generate_budgets"
       end
       # resource path
-      local_var_path = '/users/{user_guid}/budgets/{budget_guid}'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s)).sub('{' + 'budget_guid' + '}', CGI.escape(budget_guid.to_s))
+      local_var_path = '/users/{user_guid}/budgets/generate'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
 
       # header parameters
       header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.mx.api.v1+json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -64,13 +60,13 @@ module MxPlatformRuby
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type]
+      return_type = opts[:debug_return_type] || 'BudgetResponseBody'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['basicAuth']
 
       new_options = opts.merge(
-        :operation => :"BudgetsApi.users_user_guid_budgets_budget_guid_delete",
+        :operation => :"BudgetsApi.auto_generate_budgets",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -79,44 +75,44 @@ module MxPlatformRuby
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: BudgetsApi#users_user_guid_budgets_budget_guid_delete\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: BudgetsApi#auto_generate_budgets\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Read a specific budget
-    # Read a specific budget.
-    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
-    # @param user_guid [String] The unique identifier for the budget. Defined by MX.
+    # Create a budget
+    # Create a budget. This endpoint accepts the optional `MX-Skip-Webhook` header and `skip_webhook` parameter. You cannot create a duplicate budget. For example, if you attempt to create a budget for \"Gas\", but that budget already exist, the request will fail. You can retrieve a list of all existing categories by using the List Categories endpoint.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
+    # @param budget_create_request_body [BudgetCreateRequestBody] 
     # @param [Hash] opts the optional parameters
     # @return [BudgetResponseBody]
-    def users_user_guid_budgets_budget_guid_get(budget_guid, user_guid, opts = {})
-      data, _status_code, _headers = users_user_guid_budgets_budget_guid_get_with_http_info(budget_guid, user_guid, opts)
+    def create_budget(user_guid, budget_create_request_body, opts = {})
+      data, _status_code, _headers = create_budget_with_http_info(user_guid, budget_create_request_body, opts)
       data
     end
 
-    # Read a specific budget
-    # Read a specific budget.
-    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
-    # @param user_guid [String] The unique identifier for the budget. Defined by MX.
+    # Create a budget
+    # Create a budget. This endpoint accepts the optional &#x60;MX-Skip-Webhook&#x60; header and &#x60;skip_webhook&#x60; parameter. You cannot create a duplicate budget. For example, if you attempt to create a budget for \&quot;Gas\&quot;, but that budget already exist, the request will fail. You can retrieve a list of all existing categories by using the List Categories endpoint.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
+    # @param budget_create_request_body [BudgetCreateRequestBody] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(BudgetResponseBody, Integer, Hash)>] BudgetResponseBody data, response status code and response headers
-    def users_user_guid_budgets_budget_guid_get_with_http_info(budget_guid, user_guid, opts = {})
+    def create_budget_with_http_info(user_guid, budget_create_request_body, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: BudgetsApi.users_user_guid_budgets_budget_guid_get ...'
-      end
-      # verify the required parameter 'budget_guid' is set
-      if @api_client.config.client_side_validation && budget_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'budget_guid' when calling BudgetsApi.users_user_guid_budgets_budget_guid_get"
+        @api_client.config.logger.debug 'Calling API: BudgetsApi.create_budget ...'
       end
       # verify the required parameter 'user_guid' is set
       if @api_client.config.client_side_validation && user_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.users_user_guid_budgets_budget_guid_get"
+        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.create_budget"
+      end
+      # verify the required parameter 'budget_create_request_body' is set
+      if @api_client.config.client_side_validation && budget_create_request_body.nil?
+        fail ArgumentError, "Missing the required parameter 'budget_create_request_body' when calling BudgetsApi.create_budget"
       end
       # resource path
-      local_var_path = '/users/{user_guid}/budgets/{budget_guid}'.sub('{' + 'budget_guid' + '}', CGI.escape(budget_guid.to_s)).sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s))
+      local_var_path = '/users/{user_guid}/budgets'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -125,12 +121,17 @@ module MxPlatformRuby
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/vnd.mx.api.v1+json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(budget_create_request_body)
 
       # return_type
       return_type = opts[:debug_return_type] || 'BudgetResponseBody'
@@ -139,7 +140,7 @@ module MxPlatformRuby
       auth_names = opts[:debug_auth_names] || ['basicAuth']
 
       new_options = opts.merge(
-        :operation => :"BudgetsApi.users_user_guid_budgets_budget_guid_get",
+        :operation => :"BudgetsApi.create_budget",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -148,43 +149,41 @@ module MxPlatformRuby
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: BudgetsApi#users_user_guid_budgets_budget_guid_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: BudgetsApi#create_budget\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Update a specific budget
-    # Update a specific budget.
-    # @param user_guid [String] The unique identifier for the budget. Defined by MX.
+    # Delete a budget
+    # Delete a budget.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
     # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
     # @param [Hash] opts the optional parameters
-    # @option opts [BudgetUpdateRequestBody] :budget_update_request_body 
-    # @return [BudgetResponseBody]
-    def users_user_guid_budgets_budget_guid_put(user_guid, budget_guid, opts = {})
-      data, _status_code, _headers = users_user_guid_budgets_budget_guid_put_with_http_info(user_guid, budget_guid, opts)
-      data
+    # @return [nil]
+    def delete_budget(user_guid, budget_guid, opts = {})
+      delete_budget_with_http_info(user_guid, budget_guid, opts)
+      nil
     end
 
-    # Update a specific budget
-    # Update a specific budget.
-    # @param user_guid [String] The unique identifier for the budget. Defined by MX.
+    # Delete a budget
+    # Delete a budget.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
     # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
     # @param [Hash] opts the optional parameters
-    # @option opts [BudgetUpdateRequestBody] :budget_update_request_body 
-    # @return [Array<(BudgetResponseBody, Integer, Hash)>] BudgetResponseBody data, response status code and response headers
-    def users_user_guid_budgets_budget_guid_put_with_http_info(user_guid, budget_guid, opts = {})
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_budget_with_http_info(user_guid, budget_guid, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: BudgetsApi.users_user_guid_budgets_budget_guid_put ...'
+        @api_client.config.logger.debug 'Calling API: BudgetsApi.delete_budget ...'
       end
       # verify the required parameter 'user_guid' is set
       if @api_client.config.client_side_validation && user_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.users_user_guid_budgets_budget_guid_put"
+        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.delete_budget"
       end
       # verify the required parameter 'budget_guid' is set
       if @api_client.config.client_side_validation && budget_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'budget_guid' when calling BudgetsApi.users_user_guid_budgets_budget_guid_put"
+        fail ArgumentError, "Missing the required parameter 'budget_guid' when calling BudgetsApi.delete_budget"
       end
       # resource path
       local_var_path = '/users/{user_guid}/budgets/{budget_guid}'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s)).sub('{' + 'budget_guid' + '}', CGI.escape(budget_guid.to_s))
@@ -194,28 +193,21 @@ module MxPlatformRuby
 
       # header parameters
       header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
-      # HTTP header 'Content-Type'
-      content_type = @api_client.select_header_content_type(['application/json'])
-      if !content_type.nil?
-          header_params['Content-Type'] = content_type
-      end
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'budget_update_request_body'])
+      post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'BudgetResponseBody'
+      return_type = opts[:debug_return_type]
 
       # auth_names
       auth_names = opts[:debug_auth_names] || ['basicAuth']
 
       new_options = opts.merge(
-        :operation => :"BudgetsApi.users_user_guid_budgets_budget_guid_put",
+        :operation => :"BudgetsApi.delete_budget",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -224,38 +216,38 @@ module MxPlatformRuby
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: BudgetsApi#users_user_guid_budgets_budget_guid_put\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: BudgetsApi#delete_budget\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Auto-generate budgets
-    # This endpoint will automatically create budgets for several categories based on existing transactions; these budgets are returned as an array. Specifically, budgets will only be generated if the `user` has at least one `transaction` in a given category during each of the two previous calendar months. For example, if the request is made on March 6, and there is at least one \"Bills & Utilities\" `transaction` in both January and February, a budget will be generated for \"Bills & Utilities.\" If there are two \"Bills & Utilities\" transactions in February but none in January, no budget will be generated for that category. If budgets already exist for particular categories, new budgets will be generated and returned based on the available transactions. If one or more budgets remain unchanged, they will nevertheless be returned in the response. If no transaction data for the `user` meet the above criteria, a `422 Unprocessable Entity` error will be returned with status code 4221 along with the message, `There aren't enough transactions to automatically create any budgets`.
-    # @param user_guid [String] The unique identifier for the user. Defined by MX.
+    # List all budgets
+    # List all budgets
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
     # @param [Hash] opts the optional parameters
     # @return [BudgetResponseBody]
-    def users_user_guid_budgets_generate_post(user_guid, opts = {})
-      data, _status_code, _headers = users_user_guid_budgets_generate_post_with_http_info(user_guid, opts)
+    def list_all_budgets(user_guid, opts = {})
+      data, _status_code, _headers = list_all_budgets_with_http_info(user_guid, opts)
       data
     end
 
-    # Auto-generate budgets
-    # This endpoint will automatically create budgets for several categories based on existing transactions; these budgets are returned as an array. Specifically, budgets will only be generated if the &#x60;user&#x60; has at least one &#x60;transaction&#x60; in a given category during each of the two previous calendar months. For example, if the request is made on March 6, and there is at least one \&quot;Bills &amp; Utilities\&quot; &#x60;transaction&#x60; in both January and February, a budget will be generated for \&quot;Bills &amp; Utilities.\&quot; If there are two \&quot;Bills &amp; Utilities\&quot; transactions in February but none in January, no budget will be generated for that category. If budgets already exist for particular categories, new budgets will be generated and returned based on the available transactions. If one or more budgets remain unchanged, they will nevertheless be returned in the response. If no transaction data for the &#x60;user&#x60; meet the above criteria, a &#x60;422 Unprocessable Entity&#x60; error will be returned with status code 4221 along with the message, &#x60;There aren&#39;t enough transactions to automatically create any budgets&#x60;.
-    # @param user_guid [String] The unique identifier for the user. Defined by MX.
+    # List all budgets
+    # List all budgets
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
     # @param [Hash] opts the optional parameters
     # @return [Array<(BudgetResponseBody, Integer, Hash)>] BudgetResponseBody data, response status code and response headers
-    def users_user_guid_budgets_generate_post_with_http_info(user_guid, opts = {})
+    def list_all_budgets_with_http_info(user_guid, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: BudgetsApi.users_user_guid_budgets_generate_post ...'
+        @api_client.config.logger.debug 'Calling API: BudgetsApi.list_all_budgets ...'
       end
       # verify the required parameter 'user_guid' is set
       if @api_client.config.client_side_validation && user_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.users_user_guid_budgets_generate_post"
+        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.list_all_budgets"
       end
       # resource path
-      local_var_path = '/users/{user_guid}/budgets/generate'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s))
+      local_var_path = '/users/{user_guid}/budgets'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -263,7 +255,7 @@ module MxPlatformRuby
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.mx.api.v1+json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -278,7 +270,7 @@ module MxPlatformRuby
       auth_names = opts[:debug_auth_names] || ['basicAuth']
 
       new_options = opts.merge(
-        :operation => :"BudgetsApi.users_user_guid_budgets_generate_post",
+        :operation => :"BudgetsApi.list_all_budgets",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -287,38 +279,44 @@ module MxPlatformRuby
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: BudgetsApi#users_user_guid_budgets_generate_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: BudgetsApi#list_all_budgets\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # List all budgets
-    # List all budgets
-    # @param user_guid [String] The unique identifier for the user. Defined by MX.
+    # Read a specific budget
+    # Read a specific budget.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
+    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
     # @param [Hash] opts the optional parameters
     # @return [BudgetResponseBody]
-    def users_user_guid_budgets_get(user_guid, opts = {})
-      data, _status_code, _headers = users_user_guid_budgets_get_with_http_info(user_guid, opts)
+    def read_specific_budget(user_guid, budget_guid, opts = {})
+      data, _status_code, _headers = read_specific_budget_with_http_info(user_guid, budget_guid, opts)
       data
     end
 
-    # List all budgets
-    # List all budgets
-    # @param user_guid [String] The unique identifier for the user. Defined by MX.
+    # Read a specific budget
+    # Read a specific budget.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
+    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
     # @param [Hash] opts the optional parameters
     # @return [Array<(BudgetResponseBody, Integer, Hash)>] BudgetResponseBody data, response status code and response headers
-    def users_user_guid_budgets_get_with_http_info(user_guid, opts = {})
+    def read_specific_budget_with_http_info(user_guid, budget_guid, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: BudgetsApi.users_user_guid_budgets_get ...'
+        @api_client.config.logger.debug 'Calling API: BudgetsApi.read_specific_budget ...'
       end
       # verify the required parameter 'user_guid' is set
       if @api_client.config.client_side_validation && user_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.users_user_guid_budgets_get"
+        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.read_specific_budget"
+      end
+      # verify the required parameter 'budget_guid' is set
+      if @api_client.config.client_side_validation && budget_guid.nil?
+        fail ArgumentError, "Missing the required parameter 'budget_guid' when calling BudgetsApi.read_specific_budget"
       end
       # resource path
-      local_var_path = '/users/{user_guid}/budgets'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s))
+      local_var_path = '/users/{user_guid}/budgets/{budget_guid}'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s)).sub('{' + 'budget_guid' + '}', CGI.escape(budget_guid.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -326,7 +324,7 @@ module MxPlatformRuby
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.mx.api.v1+json']) unless header_params['Accept']
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -341,7 +339,7 @@ module MxPlatformRuby
       auth_names = opts[:debug_auth_names] || ['basicAuth']
 
       new_options = opts.merge(
-        :operation => :"BudgetsApi.users_user_guid_budgets_get",
+        :operation => :"BudgetsApi.read_specific_budget",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -352,42 +350,44 @@ module MxPlatformRuby
 
       data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: BudgetsApi#users_user_guid_budgets_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: BudgetsApi#read_specific_budget\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
 
-    # Create a budget
-    # Create a budget. This endpoint accepts the optional `MX-Skip-Webhook` header and `skip_webhook` parameter. You cannot create a duplicate budget. For example, if you attempt to create a budget for \"Gas\", but that budget already exist, the request will fail. You can retrieve a list of all existing categories by using the List Categories endpoint.
-    # @param user_guid [String] The unique identifier for the user. Defined by MX.
-    # @param budget_create_request_body [BudgetCreateRequestBody] 
+    # Update a specific budget
+    # Update a specific budget.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
+    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
     # @param [Hash] opts the optional parameters
+    # @option opts [BudgetUpdateRequestBody] :budget_update_request_body 
     # @return [BudgetResponseBody]
-    def users_user_guid_budgets_post(user_guid, budget_create_request_body, opts = {})
-      data, _status_code, _headers = users_user_guid_budgets_post_with_http_info(user_guid, budget_create_request_body, opts)
+    def update_specific_budget(user_guid, budget_guid, opts = {})
+      data, _status_code, _headers = update_specific_budget_with_http_info(user_guid, budget_guid, opts)
       data
     end
 
-    # Create a budget
-    # Create a budget. This endpoint accepts the optional &#x60;MX-Skip-Webhook&#x60; header and &#x60;skip_webhook&#x60; parameter. You cannot create a duplicate budget. For example, if you attempt to create a budget for \&quot;Gas\&quot;, but that budget already exist, the request will fail. You can retrieve a list of all existing categories by using the List Categories endpoint.
-    # @param user_guid [String] The unique identifier for the user. Defined by MX.
-    # @param budget_create_request_body [BudgetCreateRequestBody] 
+    # Update a specific budget
+    # Update a specific budget.
+    # @param user_guid [String] The unique identifier for a &#x60;user&#x60;, beginning with the prefix &#x60;USR-&#x60;.
+    # @param budget_guid [String] The unique identifier for the budget. Defined by MX.
     # @param [Hash] opts the optional parameters
+    # @option opts [BudgetUpdateRequestBody] :budget_update_request_body 
     # @return [Array<(BudgetResponseBody, Integer, Hash)>] BudgetResponseBody data, response status code and response headers
-    def users_user_guid_budgets_post_with_http_info(user_guid, budget_create_request_body, opts = {})
+    def update_specific_budget_with_http_info(user_guid, budget_guid, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: BudgetsApi.users_user_guid_budgets_post ...'
+        @api_client.config.logger.debug 'Calling API: BudgetsApi.update_specific_budget ...'
       end
       # verify the required parameter 'user_guid' is set
       if @api_client.config.client_side_validation && user_guid.nil?
-        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.users_user_guid_budgets_post"
+        fail ArgumentError, "Missing the required parameter 'user_guid' when calling BudgetsApi.update_specific_budget"
       end
-      # verify the required parameter 'budget_create_request_body' is set
-      if @api_client.config.client_side_validation && budget_create_request_body.nil?
-        fail ArgumentError, "Missing the required parameter 'budget_create_request_body' when calling BudgetsApi.users_user_guid_budgets_post"
+      # verify the required parameter 'budget_guid' is set
+      if @api_client.config.client_side_validation && budget_guid.nil?
+        fail ArgumentError, "Missing the required parameter 'budget_guid' when calling BudgetsApi.update_specific_budget"
       end
       # resource path
-      local_var_path = '/users/{user_guid}/budgets'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s))
+      local_var_path = '/users/{user_guid}/budgets/{budget_guid}'.sub('{' + 'user_guid' + '}', CGI.escape(user_guid.to_s)).sub('{' + 'budget_guid' + '}', CGI.escape(budget_guid.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -397,7 +397,7 @@ module MxPlatformRuby
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
       # HTTP header 'Content-Type'
-      content_type = @api_client.select_header_content_type(['application/json'])
+      content_type = @api_client.select_header_content_type(['application/vnd.mx.api.v1+json'])
       if !content_type.nil?
           header_params['Content-Type'] = content_type
       end
@@ -406,7 +406,7 @@ module MxPlatformRuby
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(budget_create_request_body)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'budget_update_request_body'])
 
       # return_type
       return_type = opts[:debug_return_type] || 'BudgetResponseBody'
@@ -415,7 +415,7 @@ module MxPlatformRuby
       auth_names = opts[:debug_auth_names] || ['basicAuth']
 
       new_options = opts.merge(
-        :operation => :"BudgetsApi.users_user_guid_budgets_post",
+        :operation => :"BudgetsApi.update_specific_budget",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
@@ -424,9 +424,9 @@ module MxPlatformRuby
         :return_type => return_type
       )
 
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: BudgetsApi#users_user_guid_budgets_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: BudgetsApi#update_specific_budget\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end