blueprint_ruby_client 0.5.2 → 0.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5fe7bdb24acb8e8a338f7f0a477fd0b987b100ba
-  data.tar.gz: dfd2b5ee16931be16d7884ddb5ed1c25b91df76e
+  metadata.gz: cae5fd8293fbf977218f123f1eba948f86aabe1d
+  data.tar.gz: 6c34d8cd923e376caadf74b3f3c22263000ced95
 SHA512:
-  metadata.gz: 483c43af5f79233afa97f7aa4a599a0e265d275ba8f5a7d164190b924556d21d973a47d0b378f7b39972ac32c12089798921cdc665d40d81b1f366e263359372
-  data.tar.gz: 0f6570c1316b001e36613dc42799dda49b1bb2a272921650b128deec785d3afe2192d3701a267a95db1bdd6a7b4988f27085b3da954590197fe62b51273745ff
+  metadata.gz: 0dc170f6077cae862957023528800b43cefd2daec63f414c561dd1406e25336cf4669604e68fd63e9e3f2a03777344daf24733766c1eca07978fc910b53d74ee
+  data.tar.gz: 01e33c3ac6d8a2ce4a4a5875f0c36806d8e2241acc4c24c12535e762f948ef7bad811b5e02293c24fdec02c9497ef50fe8a642d6d0d56e68fb1be8d6f7f27320

data/README.md

@@ -8,7 +8,7 @@ This SDK is automatically generated by the [Swagger Codegen](https://github.com/
 
 - API version: 1.0.0
 - Package version: 0.5.2
-- Build date: 2017-01-06T16:19:57.389-05:00
+- Build date: 2017-03-29T15:28:48.629+01:00
 - Build package: class io.swagger.codegen.languages.RubyClientCodegen
 
 ## Installation
@@ -73,7 +73,7 @@ end
 
 api_instance = BlueprintClient::AssetTypeConfigsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_type = "asset_type_example" # String | subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
 

data/config.json

@@ -1,7 +1,7 @@
 {
   "gemName": "blueprint_ruby_client",
   "moduleName": "BlueprintClient",
-  "gemVersion": "0.5.2",
+  "gemVersion": "0.5.3",
   "gemLicense": "Copyright Talis Education Ltd",
   "gemHomepage": "https://github.com/talis/blueprint_rb",
   "gemSummary": "A ruby API wrapper for Blueprint",

data/docs/AssetTypeConfigsApi.md

@@ -26,7 +26,7 @@ end
 
 api_instance = BlueprintClient::AssetTypeConfigsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_type = "asset_type_example" # String | subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
 
@@ -43,7 +43,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **asset_type** | **String**| subtype of Asset, e.g. 'textbooks', 'digitisations', etc. | 
 
 ### Return type

data/docs/AssetTypeTemplatesApi.md

@@ -28,7 +28,7 @@ end
 
 api_instance = BlueprintClient::AssetTypeTemplatesApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_type = "asset_type_example" # String | subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
 
@@ -47,7 +47,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **asset_type** | **String**| subtype of Asset, e.g. 'textbooks', 'digitisations', etc. | 
  **template_body** | [**TemplateBody**](TemplateBody.md)| template body | 
 
@@ -85,7 +85,7 @@ end
 
 api_instance = BlueprintClient::AssetTypeTemplatesApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_type = "asset_type_example" # String | subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
 
@@ -102,7 +102,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **asset_type** | **String**| subtype of Asset, e.g. 'textbooks', 'digitisations', etc. | 
 
 ### Return type
@@ -139,7 +139,7 @@ end
 
 api_instance = BlueprintClient::AssetTypeTemplatesApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_type = "asset_type_example" # String | subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
 
@@ -158,7 +158,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **asset_type** | **String**| subtype of Asset, e.g. 'textbooks', 'digitisations', etc. | 
  **template_body** | [**TemplateBody**](TemplateBody.md)| template body | 
 

data/docs/AssetsApi.md

@@ -32,7 +32,7 @@ end
 
 api_instance = BlueprintClient::AssetsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 type = "type_example" # String | subtype of Node, e.g. 'modules', 'departments', etc.
 
@@ -55,7 +55,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
  **id** | **String**| id identifying a domain model | 
  **asset_type** | **String**| subtype of Asset, e.g. 'textbooks', 'digitisations', etc. | 
@@ -95,7 +95,7 @@ end
 
 api_instance = BlueprintClient::AssetsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_id = "asset_id_example" # String | id of an asset
 
@@ -113,7 +113,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **asset_id** | **String**| id of an asset | 
  **asset_type** | **String**| subtype of Asset, e.g. 'textbooks', 'digitisations', etc. | 
 
@@ -151,7 +151,7 @@ end
 
 api_instance = BlueprintClient::AssetsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_type = "asset_type_example" # String | subtype of Asset, e.g. 'textbooks', 'digitisations', etc.
 
@@ -171,7 +171,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **asset_type** | **String**| subtype of Asset, e.g. 'textbooks', 'digitisations', etc. | 
  **asset_id** | **String**| id of an asset | 
 
@@ -209,14 +209,14 @@ end
 
 api_instance = BlueprintClient::AssetsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 type = "type_example" # String | subtype of Node, e.g. 'modules', 'departments', etc.
 
 id = "id_example" # String | id identifying a domain model
 
 opts = { 
-  filter_asset_type: ["filter_asset_type_example"], # Array<String> | type of asset to return
+  filter_asset_type: ["filter_asset_type_example"], # Array<String> | type of asset to return. Depricated. This filters the results by asset type, but incorrectly only returns the assets of thay type. Use asset.type.2
   offset: 3.4, # Float | index to start result set from
   limit: 3.4 # Float | number of records to return
 }
@@ -233,10 +233,10 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **type** | **String**| subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc. | 
  **id** | **String**| id identifying a domain model | 
- **filter_asset_type** | [**Array&lt;String&gt;**](String.md)| type of asset to return | [optional] 
+ **filter_asset_type** | [**Array&lt;String&gt;**](String.md)| type of asset to return. Depricated. This filters the results by asset type, but incorrectly only returns the assets of thay type. Use asset.type.2 | [optional] 
  **offset** | [**Float**](.md)| index to start result set from | [optional] 
  **limit** | [**Float**](.md)| number of records to return | [optional] 
 
@@ -274,7 +274,7 @@ end
 
 api_instance = BlueprintClient::AssetsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 type = "type_example" # String | subtype of Node, e.g. 'modules', 'departments', etc.
 
@@ -296,7 +296,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **type** | **String**| subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc. | 
  **id** | **String**| id identifying a domain model | 
  **asset_type** | **String**| subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc. | 
@@ -336,7 +336,7 @@ end
 
 api_instance = BlueprintClient::AssetsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 asset_id = "asset_id_example" # String | id of an asset
 
@@ -359,7 +359,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **asset_id** | **String**| id of an asset | 
  **asset_type** | **String**| subtype of Asset, e.g. &#39;textbooks&#39;, &#39;digitisations&#39;, etc. | 
  **body** | [**AssetBody**](AssetBody.md)| asset | [optional] 
@@ -398,14 +398,14 @@ end
 
 api_instance = BlueprintClient::AssetsApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 opts = { 
   offset: 3.4, # Float | index to start result set from
   limit: 3.4 # Float | number of records to return
   include: ["include_example"] # Array<String> | comma separated list of elements to hydrate. Can include children, parents, nodes, and/or assets
   filter_node: ["filter_node_example"], # Array<String> | limit to assets that are related to a node matching type/code
-  filter_asset_type: ["filter_asset_type_example"], # Array<String> | type of asset to return
+  filter_asset_type: ["filter_asset_type_example"], # Array<String> | type of asset to return. Depricated. This filters the results by asset type, but incorrectly only returns the assets of thay type. Use asset.type.2
 }
 
 begin
@@ -421,12 +421,12 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **offset** | [**Float**](.md)| index to start result set from | [optional] 
  **limit** | [**Float**](.md)| number of records to return | [optional] 
  **include** | [**Array&lt;String&gt;**](String.md)| comma separated list of elements to hydrate. Can include children, parents, nodes, and/or assets | [optional] 
  **filter_node** | [**Array&lt;String&gt;**](String.md)| limit to assets that are related to a node matching type/code | [optional] 
- **filter_asset_type** | [**Array&lt;String&gt;**](String.md)| type of asset to return | [optional] 
+ **filter_asset_type** | [**Array&lt;String&gt;**](String.md)| type of asset to return. Depricated. This filters the results by asset type, but incorrectly only returns the assets of thay type. Use asset.type.2 | [optional] 
 
 ### Return type
 

data/docs/HierarchyApi.md

@@ -91,7 +91,7 @@ end
 
 api_instance = BlueprintClient::HierarchyApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 
 begin
@@ -105,7 +105,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
 
 ### Return type
 
@@ -141,7 +141,7 @@ end
 
 api_instance = BlueprintClient::HierarchyApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 id = "id_example" # String | id identifying a domain model
 
@@ -159,7 +159,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **id** | **String**| id identifying a domain model | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
 
@@ -197,7 +197,7 @@ end
 
 api_instance = BlueprintClient::HierarchyApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 
 begin
@@ -211,7 +211,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
 
 ### Return type
 
@@ -249,7 +249,7 @@ api_instance = BlueprintClient::HierarchyApi.new
 
 id = "id_example" # String | id identifying a domain model
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 type = "type_example" # String | subtype of Node, e.g. 'modules', 'departments', etc.
 
@@ -272,7 +272,7 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **id** | **String**| id identifying a domain model | 
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
  **offset** | [**Float**](.md)| index to start result set from | [optional] 
  **limit** | [**Float**](.md)| number of records to return | [optional] 
@@ -313,7 +313,7 @@ api_instance = BlueprintClient::HierarchyApi.new
 
 id = "id_example" # String | id identifying a domain model
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 type = "type_example" # String | subtype of Node, e.g. 'modules', 'departments', etc.
 
@@ -336,7 +336,7 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **id** | **String**| id identifying a domain model | 
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
  **offset** | [**Float**](.md)| index to start result set from | [optional] 
  **limit** | [**Float**](.md)| number of records to return | [optional] 
@@ -377,7 +377,7 @@ api_instance = BlueprintClient::HierarchyApi.new
 
 id = "id_example" # String | id identifying a domain model
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 type = "type_example" # String | subtype of Node, e.g. 'modules', 'departments', etc.
 
@@ -400,7 +400,7 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **id** | **String**| id identifying a domain model | 
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
  **offset** | [**Float**](.md)| index to start result set from | [optional] 
  **limit** | [**Float**](.md)| number of records to return | [optional] 
@@ -439,7 +439,7 @@ end
 
 api_instance = BlueprintClient::HierarchyApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 id = "id_example" # String | id identifying a domain model
 
@@ -462,7 +462,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **id** | **String**| id identifying a domain model | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
  **include** | [**Array<String>**](String.md)| comma separated list of elements to hydrate. Can include children, parents, nodes, and/or assets | [optional] 
@@ -503,7 +503,7 @@ api_instance = BlueprintClient::HierarchyApi.new
 
 id = "id_example" # String | id identifying a domain model
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 type = "type_example" # String | subtype of Node, e.g. 'modules', 'departments', etc.
 
@@ -526,7 +526,7 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **id** | **String**| id identifying a domain model | 
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
  **offset** | [**Float**](.md)| index to start result set from | [optional] 
  **limit** | [**Float**](.md)| number of records to return | [optional] 
@@ -565,7 +565,7 @@ end
 
 api_instance = BlueprintClient::HierarchyApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 id = "id_example" # String | id identifying a domain model
 
@@ -587,7 +587,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **id** | **String**| id identifying a domain model | 
  **body** | [**NodeBody**](NodeBody.md)| node | 
  **type** | **String**| subtype of Node, e.g. 'modules', 'departments', etc. | 
@@ -612,7 +612,7 @@ Name | Type | Description  | Notes
 
 Search nodes
 
-This endpoint is a really flexible way to ask questions about the hierarchy.\nThe includes parameter can be set to either parents, children, assets.\n\nExamples:\n\n###### Find all nodes for abc:\n`/1/abc/nodes`\n\n###### Find all modules for abc:\n`/1/abc/nodes?filter[nodeType]=Modules`\n\n###### Find all nodes that are descendants of DEP101:\n`/1/abc/nodes?filter[descendant]=departments%2Fdep101`\n\n###### Find all nodes that are descendants of DEP101 or DEP102:\n`/1/abc/nodes?filter[descendant]=departments%2Fdep101,departments%2Fdep102`\n\n###### Find all nodes that are descendants of DEP101 and DEP102:\n`/1/abc/nodes?filter[descendant]=departments%2Fdep101&filter[descendant]=departments%2Fdep102``\n\n###### Find all Departments that are ancestors of ABF203:\n`/1/abc/nodes?filter[descendant]=modules%2Fabf203&filter[nodeType]=Departments` # <= case insensitive\n\n###### Find all nodes with list assets that are descendants of DEP101 for abc:\n`/1/abc/nodes?filter[nodeType]=Modules&filter[ancestor]=departments%2FDEP101&filter[hasAssets]=true&filter[assetType]=Lists`\n\n###### Globally, find all modules that have no list assets\n`/1/global/nodes?filter[nodeType]=Modules&filter[hasAssets]=false&filter[assetType]=Lists`\n\n###### 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\n`/1/global/nodes?filter[nodeType]=Modules&filter[hasAssets]=false&filter[from]=20150101&filter[to]=20151231`\n\n###### Find all nodes of type modules with assets which are also related to DEP101.\n`/1/global/nodes?filter[nodeType]=Modules&filter[hasAssets]=true&filter[assetNode]=departments%2Fdep101`\n
+This endpoint is a really flexible way to ask questions about the hierarchy.\nThe includes parameter can be set to either parents, children, assets.\n\nExamples:\n\n###### Find all nodes for abc:\n`/1/abc/nodes`\n\n###### Find all modules for abc:\n`/1/abc/nodes?filter[nodeType]=Modules`\n\n###### Find all nodes that are descendants of DEP101:\n`/1/abc/nodes?filter[descendant]=departments%2Fdep101`\n\n###### Find all nodes that are descendants of DEP101 or DEP102:\n`/1/abc/nodes?filter[descendant]=departments%2Fdep101,departments%2Fdep102`\n\n###### Find all nodes that are descendants of DEP101 and DEP102:\n`/1/abc/nodes?filter[descendant]=departments%2Fdep101&filter[descendant]=departments%2Fdep102``\n\n###### Find all Departments that are ancestors of ABF203:\n`/1/abc/nodes?filter[descendant]=modules%2Fabf203&filter[nodeType]=Departments` # <= case insensitive\n\n###### Find all nodes with list assets that are descendants of DEP101 for abc:\n`/1/abc/nodes?filter[nodeType]=Modules&filter[ancestor]=departments%2FDEP101&filter[hasAssets]=true&filter[assetType]=Lists`\n\n###### Globally, find all modules that have no list assets\n`/1/global/nodes?filter[nodeType]=Modules&filter[hasAssets]=false&filter[assetType]=Lists`\n\n###### 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\n`/1/global/nodes?filter[nodeType]=Modules&filter[hasAssets]=false&filter[from]=20150101&filter[to]=20151231`\n\n###### Find all nodes of type modules with assets which are also related to DEP101.\n`/1/global/nodes?filter[nodeType]=Modules&filter[asset.node]=departments%2Fdep101`\n
 
 ### Example
 ```ruby
@@ -639,7 +639,8 @@ opts = {
   filter_ancestor: ["filter_ancestor_example"], # Array<String> | limit to nodes with ancestor matching type/code
   filter_descendant: ["filter_descendant_example"], # Array<String> | limit to nodes with descendant matching type/code
   filter_has_assets: true, # BOOLEAN | limit to either nodes that have assets (true) nodes that have no assets (false) or omit to consider both nodes with and without assets
-  filter_asset_type: ["filter_asset_type_example"], # Array<String> | type of asset to return
+  filter_asset_type: ["filter_asset_type_example"], # Array<String> | type of asset to return. Depricated. This filters the results by asset type, but incorrectly only returns the assets of thay type. Use asset.type.2
+  filter_asset_type2: ["filter_asset_type_example"], # Array<String> | type of asset to return. Version 2. This filters the results by asset type, but returns all the assets associated with the result.
   filter_from: Date.parse("2013-10-20"), # Date | limit to results valid after this date, format is  ISO8601 date
   filter_to: Date.parse("2013-10-20"), # Date | limit to results valid before this date, format is  ISO8601
   q_node: "q_node_example", # String | query term(s) to search for nodes.  Allows wildcard searching with '*'
@@ -674,7 +675,8 @@ Name | Type | Description  | Notes
  **filter_ancestor** | [**Array&lt;String&gt;**](String.md)| limit to nodes with ancestor matching type/code | [optional] 
  **filter_descendant** | [**Array&lt;String&gt;**](String.md)| limit to nodes with descendant matching type/code | [optional] 
  **filter_has_assets** | **BOOLEAN**| limit to either nodes that have assets (true) nodes that have no assets (false) or omit to consider both nodes with and without assets | [optional] 
- **filter_asset_type** | [**Array&lt;String&gt;**](String.md)| type of asset to return | [optional] 
+ **filter_asset_type** | [**Array&lt;String&gt;**](String.md)| type of asset to return. Depricated. This filters the results by asset type, but incorrectly only returns the assets of thay type. Use asset.type.2 | [optional] 
+ **filter_asset_type2** | [**Array&lt;String&gt;**](String.md)| type of asset to return. Version 2. This filters the results by asset type, but returns all the assets associated with the result. | [optional] 
  **filter_from** | **Date**| limit to results valid after this date, format is  ISO8601 date | [optional] 
  **filter_to** | **Date**| limit to results valid before this date, format is  ISO8601 | [optional] 
  **q_node** | **String**| query term(s) to search for nodes.  Allows wildcard searching with &#39;*&#39; | [optional] 
@@ -718,7 +720,7 @@ end
 
 api_instance = BlueprintClient::HierarchyApi.new
 
-namespace = "namespace_example" # String | identifier namespacing the blueprint.
+namespace = "namespace_example" # String | identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores.
 
 id = "id_example" # String | id identifying a domain model
 
@@ -739,7 +741,7 @@ end
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **namespace** | **String**| identifier namespacing the blueprint. | 
+ **namespace** | **String**| identifier namespacing the blueprint. It must start with a letter or underscore and can only be followed by letters, numbers and underscores. | 
  **id** | **String**| id identifying a domain model | 
  **body** | [**NodeBody**](NodeBody.md)| node | 
  **type** | **String**| subtype of Node, e.g. &#39;modules&#39;, &#39;departments&#39;, etc. |