blueprint_ruby_client 0.4.1 → 0.5.0

data/lib/blueprint_ruby_client/api/hierarchy_api.rb

@@ -22,7 +22,7 @@ module BlueprintClient
 
     # 
     # Add a node
-    # @param namespace_inc_global identifier namespacing the blueprint. `global` is a special namespace which references data from all blueprints in the call.
+    # @param namespace_inc_global identifier namespacing the blueprint. `global` is a special namespace which references data from all blueprints in the call.
     # @param body node
     # @param [Hash] opts the optional parameters
     # @return [NodeBody]
@@ -33,7 +33,7 @@ module BlueprintClient
 
     # 
     # Add a node
-    # @param namespace_inc_global identifier namespacing the blueprint. `global` is a special namespace which references data from all blueprints in the call.
+    # @param namespace_inc_global identifier namespacing the blueprint. `global` is a special namespace which references data from all blueprints in the call.
     # @param body node
     # @param [Hash] opts the optional parameters
     # @return [Array<(NodeBody, Fixnum, Hash)>] NodeBody data, response status code and response headers
@@ -41,23 +41,10 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.add_node ..."
       end
-      
-      
       # verify the required parameter 'namespace_inc_global' is set
       fail ArgumentError, "Missing the required parameter 'namespace_inc_global' when calling HierarchyApi.add_node" if namespace_inc_global.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'body' is set
       fail ArgumentError, "Missing the required parameter 'body' when calling HierarchyApi.add_node" if body.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespaceIncGlobal}/nodes".sub('{format}','json').sub('{' + 'namespaceIncGlobal' + '}', namespace_inc_global.to_s)
 
@@ -80,7 +67,6 @@ module BlueprintClient
 
       # http body (model)
       post_body = @api_client.object_to_http_body(body)
-      
       auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
@@ -96,7 +82,7 @@ module BlueprintClient
     end
 
     # 
-    # Send operations to modify nodes in bulk, to be applied/rejected as a single transaction.\nFormat will be:\n\n  OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS\n
+    # Send operations to modify nodes in bulk, to be applied/rejected as a single transaction. Format will be:    OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS 
     # @param namespace identifier namespacing the blueprint.
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -106,7 +92,7 @@ module BlueprintClient
     end
 
     # 
-    # Send operations to modify nodes in bulk, to be applied/rejected as a single transaction.\nFormat will be:\n\n  OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS\n
+    # Send operations to modify nodes in bulk, to be applied/rejected as a single transaction. Format will be:    OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS 
     # @param namespace identifier namespacing the blueprint.
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -114,15 +100,8 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.bulk_upload ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.bulk_upload" if namespace.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes.csv".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s)
 
@@ -145,8 +124,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -163,7 +141,7 @@ module BlueprintClient
     # Delete a node
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def delete_node(namespace, id, type, opts = {})
@@ -175,38 +153,19 @@ module BlueprintClient
     # Delete a node
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
     def delete_node_with_http_info(namespace, id, type, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.delete_node ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.delete_node" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.delete_node" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.delete_node" if type.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'id' + '}', id.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -229,8 +188,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:DELETE, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -244,7 +202,7 @@ module BlueprintClient
     end
 
     # 
-    # Download the blueprint's nodes in CSV format\nFormat will be:\n\n  OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS\n\nOLD NODE TYPE and OLD NODE ID are left intentionally blank to allow direct upload of the output back into the bulk importer\n
+    # Download the blueprint's nodes in CSV format Format will be:    OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS  OLD NODE TYPE and OLD NODE ID are left intentionally blank to allow direct upload of the output back into the bulk importer 
     # @param namespace identifier namespacing the blueprint.
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -254,7 +212,7 @@ module BlueprintClient
     end
 
     # 
-    # Download the blueprint&#39;s nodes in CSV format\nFormat will be:\n\n  OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS\n\nOLD NODE TYPE and OLD NODE ID are left intentionally blank to allow direct upload of the output back into the bulk importer\n
+    # Download the blueprint&#39;s nodes in CSV format Format will be:    OLD NODE TYPE, OLD NODE ID, NEW NODE TYPE, NEW NODE ID, PARENTS, TITLE, DESCRIPTION, DOMAIN IDS, STUDENT NUMBERS  OLD NODE TYPE and OLD NODE ID are left intentionally blank to allow direct upload of the output back into the bulk importer 
     # @param namespace identifier namespacing the blueprint.
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -262,15 +220,8 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.export_hierarchy ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.export_hierarchy" if namespace.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes.csv".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s)
 
@@ -293,8 +244,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -308,10 +258,10 @@ module BlueprintClient
     end
 
     # Get ancestor nodes
-    # A proxy for finding ancestors of a given node, equivalent to\n`/1/abc/nodes?filter[descendant]=department%2Fdep101`\n
+    # A proxy for finding ancestors of a given node, equivalent to `/1/abc/nodes?filter[descendant]=department%2Fdep101` 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -322,10 +272,10 @@ module BlueprintClient
     end
 
     # Get ancestor nodes
-    # A proxy for finding ancestors of a given node, equivalent to\n`/1/abc/nodes?filter[descendant]=department%2Fdep101`\n
+    # A proxy for finding ancestors of a given node, equivalent to &#x60;/1/abc/nodes?filter[descendant]&#x3D;department%2Fdep101&#x60; 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -334,43 +284,12 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.get_ancestors ..."
       end
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.get_ancestors" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.get_ancestors" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.get_ancestors" if type.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}/ancestors".sub('{format}','json').sub('{' + 'id' + '}', id.to_s).sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -395,8 +314,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -411,10 +329,10 @@ module BlueprintClient
     end
 
     # Get child nodes
-    # A proxy for finding children of a given node, equivalent to\n`/1/abc/nodes?filter[parent]=department%2Fdep101`\n
+    # A proxy for finding children of a given node, equivalent to `/1/abc/nodes?filter[parent]=department%2Fdep101` 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -425,10 +343,10 @@ module BlueprintClient
     end
 
     # Get child nodes
-    # A proxy for finding children of a given node, equivalent to\n`/1/abc/nodes?filter[parent]=department%2Fdep101`\n
+    # A proxy for finding children of a given node, equivalent to &#x60;/1/abc/nodes?filter[parent]&#x3D;department%2Fdep101&#x60; 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -437,43 +355,12 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.get_children ..."
       end
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.get_children" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.get_children" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.get_children" if type.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}/children".sub('{format}','json').sub('{' + 'id' + '}', id.to_s).sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -498,8 +385,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -514,10 +400,10 @@ module BlueprintClient
     end
 
     # Get descendant nodes
-    # A proxy for finding descendants of a given node, equivalent to\n`/1/abc/nodes?filter[ancestor]=department%2Fdep101`\n
+    # A proxy for finding descendants of a given node, equivalent to `/1/abc/nodes?filter[ancestor]=department%2Fdep101` 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -528,10 +414,10 @@ module BlueprintClient
     end
 
     # Get descendant nodes
-    # A proxy for finding descendants of a given node, equivalent to\n`/1/abc/nodes?filter[ancestor]=department%2Fdep101`\n
+    # A proxy for finding descendants of a given node, equivalent to &#x60;/1/abc/nodes?filter[ancestor]&#x3D;department%2Fdep101&#x60; 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -540,43 +426,12 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.get_descendants ..."
       end
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.get_descendants" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.get_descendants" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.get_descendants" if type.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}/descendants".sub('{format}','json').sub('{' + 'id' + '}', id.to_s).sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -601,8 +456,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -620,7 +474,7 @@ module BlueprintClient
     # Get details of a given node
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<String>] :include comma separated list of elements to hydrate. Can include children, parents, and/or assets
     # @return [NodeBody]
@@ -633,7 +487,7 @@ module BlueprintClient
     # Get details of a given node
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<String>] :include comma separated list of elements to hydrate. Can include children, parents, and/or assets
     # @return [Array<(NodeBody, Fixnum, Hash)>] NodeBody data, response status code and response headers
@@ -641,37 +495,15 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.get_node ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.get_node" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.get_node" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.get_node" if type.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
+      if opts[:'include'] && !['children', 'parents', 'assets'].include?(opts[:'include'])
+        fail ArgumentError, 'invalid value for "include", must be one of children, parents, assets'
+      end
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'id' + '}', id.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -695,8 +527,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -711,10 +542,10 @@ module BlueprintClient
     end
 
     # Get parent nodes
-    # A proxy for finding parents of a given node, equivalent to\n`/1/abc/nodes?filter[child]=department%2Fdep101`\n
+    # A proxy for finding parents of a given node, equivalent to `/1/abc/nodes?filter[child]=department%2Fdep101` 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -725,10 +556,10 @@ module BlueprintClient
     end
 
     # Get parent nodes
-    # A proxy for finding parents of a given node, equivalent to\n`/1/abc/nodes?filter[child]=department%2Fdep101`\n
+    # A proxy for finding parents of a given node, equivalent to &#x60;/1/abc/nodes?filter[child]&#x3D;department%2Fdep101&#x60; 
     # @param id id identifying a domain model
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -737,43 +568,12 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.get_parents ..."
       end
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.get_parents" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.get_parents" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.get_parents" if type.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}/parents".sub('{format}','json').sub('{' + 'id' + '}', id.to_s).sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -798,8 +598,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -818,7 +617,7 @@ module BlueprintClient
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
     # @param body node
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [NodeBody]
     def replace_node(namespace, id, body, type, opts = {})
@@ -831,46 +630,21 @@ module BlueprintClient
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
     # @param body node
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [Array<(NodeBody, Fixnum, Hash)>] NodeBody data, response status code and response headers
     def replace_node_with_http_info(namespace, id, body, type, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.replace_node ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.replace_node" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.replace_node" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'body' is set
       fail ArgumentError, "Missing the required parameter 'body' when calling HierarchyApi.replace_node" if body.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.replace_node" if type.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'id' + '}', id.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -893,7 +667,6 @@ module BlueprintClient
 
       # http body (model)
       post_body = @api_client.object_to_http_body(body)
-      
       auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
         :header_params => header_params,
@@ -909,8 +682,8 @@ module BlueprintClient
     end
 
     # Search nodes
-    # This endpoint is a really flexible way to ask questions about the hierarchy. for example:\n\n###### Find all nodes for abc:\n`/1/abc/nodes`\n\n###### Find all modules for abc:\n`/1/abc/nodes?filter[nodeType]=Module`\n\n###### Find all nodes that are descendants of DEP101:\n`/1/abc/nodes?filter[descendant]=department%2Fdep101`\n\n###### Find all Departments that are ancestors of ABF203:\n`/1/abc/nodes?filter[descendant]=module%2Fabf203&filter[nodeType]=Department` # <= case insensitive\n\n###### Find all nodes with list assets that are descendants of DEP101 for abc:\n`/1/abc/nodes?filter[nodeType]=Module&filter[ancestor]=department%2FDEP101&filter[hasAssets]=true&filter[assetType]=List`\n\n###### Globally, find all modules that have no list assets\n`/1/global/nodes?filter[nodeType]=Module&filter[hasAssets]=false&filter[assetType]=List`\n\n###### Find all nodes of type time period valid during 2015 that have no list assets. Note a node's valid_from/valid_to just need to overlap from/to to qualify\n`/1/global/nodes?filter[nodeType]=TimePeriod&filter[hasAssets]=false&filter[assetType]=List&filter[from]=20150101&filter[to]=20151231`\n
-    # @param namespace_inc_global identifier namespacing the blueprint. `global` is a special namespace which references data from all blueprints in the call.
+    # This endpoint is a really flexible way to ask questions about the hierarchy. for example:  ###### Find all nodes for abc: `/1/abc/nodes`  ###### Find all modules for abc: `/1/abc/nodes?filter[nodeType]=Modules`  ###### Find all nodes that are descendants of DEP101: `/1/abc/nodes?filter[descendant]=departments%2Fdep101`  ###### Find all Departments that are ancestors of ABF203: `/1/abc/nodes?filter[descendant]=modules%2Fabf203&filter[nodeType]=Departments` # <= case insensitive  ###### Find all nodes with list assets that are descendants of DEP101 for abc: `/1/abc/nodes?filter[nodeType]=Modules&filter[ancestor]=departments%2FDEP101&filter[hasAssets]=true&filter[assetType]=Lists`  ###### Globally, find all modules that have no list assets `/1/global/nodes?filter[nodeType]=Modules&filter[hasAssets]=false&filter[assetType]=Lists`  ###### Find all nodes of type modules during 2015 that have no assets. Note a node's valid_from/valid_to just need to overlap from/to to qualify `/1/global/nodes?filter[nodeType]=Modules&filter[hasAssets]=false&filter[from]=20150101&filter[to]=20151231` 
+    # @param namespace_inc_global identifier namespacing the blueprint. &#x60;global&#x60; is a special namespace which references data from all blueprints in the call.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -936,8 +709,8 @@ module BlueprintClient
     end
 
     # Search nodes
-    # This endpoint is a really flexible way to ask questions about the hierarchy. for example:\n\n###### Find all nodes for abc:\n`/1/abc/nodes`\n\n###### Find all modules for abc:\n`/1/abc/nodes?filter[nodeType]=Module`\n\n###### Find all nodes that are descendants of DEP101:\n`/1/abc/nodes?filter[descendant]=department%2Fdep101`\n\n###### Find all Departments that are ancestors of ABF203:\n`/1/abc/nodes?filter[descendant]=module%2Fabf203&amp;filter[nodeType]=Department` # &lt;= case insensitive\n\n###### Find all nodes with list assets that are descendants of DEP101 for abc:\n`/1/abc/nodes?filter[nodeType]=Module&amp;filter[ancestor]=department%2FDEP101&amp;filter[hasAssets]=true&amp;filter[assetType]=List`\n\n###### Globally, find all modules that have no list assets\n`/1/global/nodes?filter[nodeType]=Module&amp;filter[hasAssets]=false&amp;filter[assetType]=List`\n\n###### Find all nodes of type time period valid during 2015 that have no list assets. Note a node&#39;s valid_from/valid_to just need to overlap from/to to qualify\n`/1/global/nodes?filter[nodeType]=TimePeriod&amp;filter[hasAssets]=false&amp;filter[assetType]=List&amp;filter[from]=20150101&amp;filter[to]=20151231`\n
-    # @param namespace_inc_global identifier namespacing the blueprint. `global` is a special namespace which references data from all blueprints in the call.
+    # This endpoint is a really flexible way to ask questions about the hierarchy. for example:  ###### Find all nodes for abc: &#x60;/1/abc/nodes&#x60;  ###### Find all modules for abc: &#x60;/1/abc/nodes?filter[nodeType]&#x3D;Modules&#x60;  ###### Find all nodes that are descendants of DEP101: &#x60;/1/abc/nodes?filter[descendant]&#x3D;departments%2Fdep101&#x60;  ###### Find all Departments that are ancestors of ABF203: &#x60;/1/abc/nodes?filter[descendant]&#x3D;modules%2Fabf203&amp;filter[nodeType]&#x3D;Departments&#x60; # &lt;&#x3D; case insensitive  ###### Find all nodes with list assets that are descendants of DEP101 for abc: &#x60;/1/abc/nodes?filter[nodeType]&#x3D;Modules&amp;filter[ancestor]&#x3D;departments%2FDEP101&amp;filter[hasAssets]&#x3D;true&amp;filter[assetType]&#x3D;Lists&#x60;  ###### Globally, find all modules that have no list assets &#x60;/1/global/nodes?filter[nodeType]&#x3D;Modules&amp;filter[hasAssets]&#x3D;false&amp;filter[assetType]&#x3D;Lists&#x60;  ###### Find all nodes of type modules during 2015 that have no assets. Note a node&#39;s valid_from/valid_to just need to overlap from/to to qualify &#x60;/1/global/nodes?filter[nodeType]&#x3D;Modules&amp;filter[hasAssets]&#x3D;false&amp;filter[from]&#x3D;20150101&amp;filter[to]&#x3D;20151231&#x60; 
+    # @param namespace_inc_global identifier namespacing the blueprint. &#x60;global&#x60; is a special namespace which references data from all blueprints in the call.
     # @param [Hash] opts the optional parameters
     # @option opts [Float] :offset index to start result set from
     # @option opts [Float] :limit number of records to return
@@ -961,117 +734,11 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.search_nodes ..."
       end
-      
-      
       # verify the required parameter 'namespace_inc_global' is set
       fail ArgumentError, "Missing the required parameter 'namespace_inc_global' when calling HierarchyApi.search_nodes" if namespace_inc_global.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
+      if opts[:'include'] && !['children', 'parents', 'assets'].include?(opts[:'include'])
+        fail ArgumentError, 'invalid value for "include", must be one of children, parents, assets'
+      end
       # resource path
       local_var_path = "/{namespaceIncGlobal}/nodes".sub('{format}','json').sub('{' + 'namespaceIncGlobal' + '}', namespace_inc_global.to_s)
 
@@ -1111,8 +778,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -1131,7 +797,7 @@ module BlueprintClient
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
     # @param body node
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [NodeBody]
     def update_node(namespace, id, body, type, opts = {})
@@ -1144,46 +810,21 @@ module BlueprintClient
     # @param namespace identifier namespacing the blueprint.
     # @param id id identifying a domain model
     # @param body node
-    # @param type Plural form of node type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [Array<(NodeBody, Fixnum, Hash)>] NodeBody data, response status code and response headers
     def update_node_with_http_info(namespace, id, body, type, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: HierarchyApi.update_node ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling HierarchyApi.update_node" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling HierarchyApi.update_node" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'body' is set
       fail ArgumentError, "Missing the required parameter 'body' when calling HierarchyApi.update_node" if body.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling HierarchyApi.update_node" if type.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'id' + '}', id.to_s).sub('{' + 'type' + '}', type.to_s)
 
@@ -1206,7 +847,6 @@ module BlueprintClient
 
       # http body (model)
       post_body = @api_client.object_to_http_body(body)
-      
       auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:PATCH, local_var_path,
         :header_params => header_params,