blueprint_ruby_client 0.4.1 → 0.5.0

data/lib/blueprint_ruby_client/api/asset_type_templates_api.rb

@@ -0,0 +1,214 @@
+=begin
+Talis Blueprint API
+
+This is the API documentation for [Blueprint](https://github.com/talis/blueprint-server), a primitive for institutional structure and time periods
+
+OpenAPI spec version: 1.0.0
+
+Generated by: https://github.com/swagger-api/swagger-codegen.git
+
+
+=end
+
+require "uri"
+
+module BlueprintClient
+  class AssetTypeTemplatesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+
+    # 
+    # Configure a template for a given asset type
+    # @param namespace identifier namespacing the blueprint.
+    # @param asset_type subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
+    # @param template_body template body
+    # @param [Hash] opts the optional parameters
+    # @return [TemplateBody]
+    def add(namespace, asset_type, template_body, opts = {})
+      data, _status_code, _headers = add_with_http_info(namespace, asset_type, template_body, opts)
+      return data
+    end
+
+    # 
+    # Configure a template for a given asset type
+    # @param namespace identifier namespacing the blueprint.
+    # @param asset_type subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
+    # @param template_body template body
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TemplateBody, Fixnum, Hash)>] TemplateBody data, response status code and response headers
+    def add_with_http_info(namespace, asset_type, template_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: AssetTypeTemplatesApi.add ..."
+      end
+      # verify the required parameter 'namespace' is set
+      fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetTypeTemplatesApi.add" if namespace.nil?
+      # verify the required parameter 'asset_type' is set
+      fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetTypeTemplatesApi.add" if asset_type.nil?
+      # verify the required parameter 'template_body' is set
+      fail ArgumentError, "Missing the required parameter 'template_body' when calling AssetTypeTemplatesApi.add" if template_body.nil?
+      # resource path
+      local_var_path = "/{namespace}/assets/{assetType}/templates".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'assetType' + '}', asset_type.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/vnd.api+json']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/json']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(template_body)
+      auth_names = ['oauth2']
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'TemplateBody')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AssetTypeTemplatesApi#add\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 
+    # Delete a template for a given asset type
+    # @param namespace identifier namespacing the blueprint.
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
+    # @param [Hash] opts the optional parameters
+    # @return [TemplateBody]
+    def delete(namespace, asset_type, opts = {})
+      data, _status_code, _headers = delete_with_http_info(namespace, asset_type, opts)
+      return data
+    end
+
+    # 
+    # Delete a template for a given asset type
+    # @param namespace identifier namespacing the blueprint.
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TemplateBody, Fixnum, Hash)>] TemplateBody data, response status code and response headers
+    def delete_with_http_info(namespace, asset_type, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: AssetTypeTemplatesApi.delete ..."
+      end
+      # verify the required parameter 'namespace' is set
+      fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetTypeTemplatesApi.delete" if namespace.nil?
+      # verify the required parameter 'asset_type' is set
+      fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetTypeTemplatesApi.delete" if asset_type.nil?
+      # resource path
+      local_var_path = "/{namespace}/assets/{assetType}/templates".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'assetType' + '}', asset_type.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/vnd.api+json']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/json']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['oauth2']
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'TemplateBody')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AssetTypeTemplatesApi#delete\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # 
+    # update a template for a given asset type
+    # @param namespace identifier namespacing the blueprint.
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
+    # @param template_body template body
+    # @param [Hash] opts the optional parameters
+    # @return [TemplateBody]
+    def put(namespace, asset_type, template_body, opts = {})
+      data, _status_code, _headers = put_with_http_info(namespace, asset_type, template_body, opts)
+      return data
+    end
+
+    # 
+    # update a template for a given asset type
+    # @param namespace identifier namespacing the blueprint.
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
+    # @param template_body template body
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TemplateBody, Fixnum, Hash)>] TemplateBody data, response status code and response headers
+    def put_with_http_info(namespace, asset_type, template_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: AssetTypeTemplatesApi.put ..."
+      end
+      # verify the required parameter 'namespace' is set
+      fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetTypeTemplatesApi.put" if namespace.nil?
+      # verify the required parameter 'asset_type' is set
+      fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetTypeTemplatesApi.put" if asset_type.nil?
+      # verify the required parameter 'template_body' is set
+      fail ArgumentError, "Missing the required parameter 'template_body' when calling AssetTypeTemplatesApi.put" if template_body.nil?
+      # resource path
+      local_var_path = "/{namespace}/assets/{assetType}/templates".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'assetType' + '}', asset_type.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/vnd.api+json']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/json']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = @api_client.object_to_http_body(template_body)
+      auth_names = ['oauth2']
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'TemplateBody')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AssetTypeTemplatesApi#put\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/blueprint_ruby_client/api/assets_api.rb

@@ -23,9 +23,9 @@ module BlueprintClient
     # 
     # Add an asset to the node.  Body must be empty.  Will upsert the asset if it doesn't exist
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an 's' to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. 'modules', 'departments', etc.
     # @param id id identifying a domain model
-    # @param asset_type Plural form of asset type (adds an 's' to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
     # @param asset_id id of an asset
     # @param [Hash] opts the optional parameters
     # @return [AssetBody]
@@ -37,9 +37,9 @@ module BlueprintClient
     # 
     # Add an asset to the node.  Body must be empty.  Will upsert the asset if it doesn't exist
     # @param namespace identifier namespacing the blueprint.
-    # @param type Plural form of node type (adds an 's' to the end of the type) todo - allow configuration of plurals
+    # @param type subtype of Node, e.g. 'modules', 'departments', etc.
     # @param id id identifying a domain model
-    # @param asset_type Plural form of asset type (adds an 's' to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
     # @param asset_id id of an asset
     # @param [Hash] opts the optional parameters
     # @return [Array<(AssetBody, Fixnum, Hash)>] AssetBody data, response status code and response headers
@@ -47,47 +47,16 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: AssetsApi.add_asset_to_node ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetsApi.add_asset_to_node" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling AssetsApi.add_asset_to_node" if type.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling AssetsApi.add_asset_to_node" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_type' is set
       fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetsApi.add_asset_to_node" if asset_type.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_id' is set
       fail ArgumentError, "Missing the required parameter 'asset_id' when calling AssetsApi.add_asset_to_node" if asset_id.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}/assets/{assetType}/{assetId}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'type' + '}', type.to_s).sub('{' + 'id' + '}', id.to_s).sub('{' + 'assetType' + '}', asset_type.to_s).sub('{' + 'assetId' + '}', asset_id.to_s)
 
@@ -110,8 +79,7 @@ module BlueprintClient
 
       # http body (model)
       post_body = nil
-      
-      auth_names = ['oauth2']
+            auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -129,7 +97,7 @@ module BlueprintClient
     # Delete an Asset
     # @param namespace identifier namespacing the blueprint.
     # @param asset_id id of an asset
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def delete_asset(namespace, asset_id, asset_type, opts = {})
@@ -141,38 +109,19 @@ module BlueprintClient
     # Delete an Asset
     # @param namespace identifier namespacing the blueprint.
     # @param asset_id id of an asset
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
     def delete_asset_with_http_info(namespace, asset_id, asset_type, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: AssetsApi.delete_asset ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetsApi.delete_asset" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_id' is set
       fail ArgumentError, "Missing the required parameter 'asset_id' when calling AssetsApi.delete_asset" if asset_id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_type' is set
       fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetsApi.delete_asset" if asset_type.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/assets/{assetType}/{assetId}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'assetId' + '}', asset_id.to_s).sub('{' + 'assetType' + '}', asset_type.to_s)
 
@@ -195,8 +144,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,
@@ -212,7 +160,7 @@ module BlueprintClient
     # 
     # Get details of a given asset
     # @param namespace identifier namespacing the blueprint.
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param asset_id id of an asset
     # @param [Hash] opts the optional parameters
     # @return [AssetBody]
@@ -224,7 +172,7 @@ module BlueprintClient
     # 
     # Get details of a given asset
     # @param namespace identifier namespacing the blueprint.
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param asset_id id of an asset
     # @param [Hash] opts the optional parameters
     # @return [Array<(AssetBody, Fixnum, Hash)>] AssetBody data, response status code and response headers
@@ -232,31 +180,12 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: AssetsApi.get_asset ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetsApi.get_asset" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_type' is set
       fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetsApi.get_asset" if asset_type.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_id' is set
       fail ArgumentError, "Missing the required parameter 'asset_id' when calling AssetsApi.get_asset" if asset_id.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/assets/{assetType}/{assetId}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'assetType' + '}', asset_type.to_s).sub('{' + 'assetId' + '}', asset_id.to_s)
 
@@ -279,8 +208,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,
@@ -297,7 +225,7 @@ module BlueprintClient
     # 
     # Get for assets in the relevant node
     # @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 id id identifying a domain model
     # @param [Hash] opts the optional parameters
     # @option opts [Array<String>] :filter_asset_type type of asset to return
@@ -312,7 +240,7 @@ module BlueprintClient
     # 
     # Get for assets in the relevant node
     # @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 id id identifying a domain model
     # @param [Hash] opts the optional parameters
     # @option opts [Array<String>] :filter_asset_type type of asset to return
@@ -323,49 +251,12 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: AssetsApi.get_assets_in_node ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetsApi.get_assets_in_node" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling AssetsApi.get_assets_in_node" if type.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling AssetsApi.get_assets_in_node" if id.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}/assets".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'type' + '}', type.to_s).sub('{' + 'id' + '}', id.to_s)
 
@@ -391,8 +282,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,
@@ -409,9 +299,9 @@ module BlueprintClient
     # 
     # Remove an asset from the relevant node
     # @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 id id identifying a domain model
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param asset_id id of an asset
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -423,9 +313,9 @@ module BlueprintClient
     # 
     # Remove an asset from the relevant node
     # @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 id id identifying a domain model
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param asset_id id of an asset
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Fixnum, Hash)>] nil, response status code and response headers
@@ -433,47 +323,16 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: AssetsApi.remove_asset_from_node ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetsApi.remove_asset_from_node" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'type' is set
       fail ArgumentError, "Missing the required parameter 'type' when calling AssetsApi.remove_asset_from_node" if type.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'id' is set
       fail ArgumentError, "Missing the required parameter 'id' when calling AssetsApi.remove_asset_from_node" if id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_type' is set
       fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetsApi.remove_asset_from_node" if asset_type.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_id' is set
       fail ArgumentError, "Missing the required parameter 'asset_id' when calling AssetsApi.remove_asset_from_node" if asset_id.nil?
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/nodes/{type}/{id}/assets/{assetType}/{assetId}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'type' + '}', type.to_s).sub('{' + 'id' + '}', id.to_s).sub('{' + 'assetType' + '}', asset_type.to_s).sub('{' + 'assetId' + '}', asset_id.to_s)
 
@@ -496,8 +355,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,
@@ -511,10 +369,10 @@ module BlueprintClient
     end
 
     # Replaces the Asset with the data sent in the body
-    # Wholesale replacement of Asset data: if you were to PUT to:\n  /1/{namespace}/assets/sometype/someid\n\nwith a body of:\n  { type: \"someothertype\", id: \"someotherid\" }\n\nIt would change the Asset's path to:\n  /1/{namespace}/assets/someothertype/someotherid\n\nand\n  /1/{namespace}/assets/sometype/someid\nwould return a 404.\nIt would also update the assets associated with any node.\n
+    # Wholesale replacement of Asset data: if you were to PUT to:   /1/{namespace}/assets/sometype/someid  with a body of:   { type: \"someothertype\", id: \"someotherid\" }  It would change the Asset's path to:   /1/{namespace}/assets/someothertype/someotherid  and   /1/{namespace}/assets/sometype/someid would return a 404. It would also update the assets associated with any node. 
     # @param namespace identifier namespacing the blueprint.
     # @param asset_id id of an asset
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [AssetBody] :body asset
     # @return [AssetBody]
@@ -524,10 +382,10 @@ module BlueprintClient
     end
 
     # Replaces the Asset with the data sent in the body
-    # Wholesale replacement of Asset data: if you were to PUT to:\n  /1/{namespace}/assets/sometype/someid\n\nwith a body of:\n  { type: \&quot;someothertype\&quot;, id: \&quot;someotherid\&quot; }\n\nIt would change the Asset&#39;s path to:\n  /1/{namespace}/assets/someothertype/someotherid\n\nand\n  /1/{namespace}/assets/sometype/someid\nwould return a 404.\nIt would also update the assets associated with any node.\n
+    # Wholesale replacement of Asset data: if you were to PUT to:   /1/{namespace}/assets/sometype/someid  with a body of:   { type: \&quot;someothertype\&quot;, id: \&quot;someotherid\&quot; }  It would change the Asset&#39;s path to:   /1/{namespace}/assets/someothertype/someotherid  and   /1/{namespace}/assets/sometype/someid would return a 404. It would also update the assets associated with any node. 
     # @param namespace identifier namespacing the blueprint.
     # @param asset_id id of an asset
-    # @param asset_type Plural form of asset type (adds an &#39;s&#39; to the end of the type) todo - allow configuration of plurals
+    # @param asset_type subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc.
     # @param [Hash] opts the optional parameters
     # @option opts [AssetBody] :body asset
     # @return [Array<(AssetBody, Fixnum, Hash)>] AssetBody data, response status code and response headers
@@ -535,37 +393,12 @@ module BlueprintClient
       if @api_client.config.debugging
         @api_client.config.logger.debug "Calling API: AssetsApi.replace_asset ..."
       end
-      
-      
       # verify the required parameter 'namespace' is set
       fail ArgumentError, "Missing the required parameter 'namespace' when calling AssetsApi.replace_asset" if namespace.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_id' is set
       fail ArgumentError, "Missing the required parameter 'asset_id' when calling AssetsApi.replace_asset" if asset_id.nil?
-      
-      
-      
-      
-      
-      
       # verify the required parameter 'asset_type' is set
       fail ArgumentError, "Missing the required parameter 'asset_type' when calling AssetsApi.replace_asset" if asset_type.nil?
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
-      
       # resource path
       local_var_path = "/{namespace}/assets/{assetType}/{assetId}".sub('{format}','json').sub('{' + 'namespace' + '}', namespace.to_s).sub('{' + 'assetId' + '}', asset_id.to_s).sub('{' + 'assetType' + '}', asset_type.to_s)
 
@@ -588,7 +421,6 @@ module BlueprintClient
 
       # http body (model)
       post_body = @api_client.object_to_http_body(opts[:'body'])
-      
       auth_names = ['oauth2']
       data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
         :header_params => header_params,