Merge pull request #67 from thingsboard/auto/update-paas-client-master

Update PAAS OpenAPI spec in master (from develop/4.4)

Author: ViacheslavKlimov

paas/docs/AiChatControllerApi.md

@@ -7,7 +7,7 @@ com.fasterxml.jackson.databind.JsonNode createChat(@Nonnull Object body) // crea
 void deleteChat(@Nonnull UUID chatId) // deleteChat
 com.fasterxml.jackson.databind.JsonNode getChatMessages(@Nonnull UUID chatId) // getChatMessages
 com.fasterxml.jackson.databind.JsonNode listChats(@Nonnull ChatType chatType) // listChats
-List<Object> sendChatMessage(@Nonnull UUID chatId, @Nonnull String xAuthorization, @Nonnull String body) // sendChatMessage
+List<Object> sendChatMessage(@Nonnull UUID chatId, @Nonnull String xAuthorization, @Nonnull Object body, @Nullable String acceptLanguage) // sendChatMessage
 void updateChat(@Nonnull UUID chatId, @Nonnull Object body) // updateChat
 ```
 
@@ -103,7 +103,7 @@ listChats
 ## sendChatMessage
 
 ```
-List<Object> sendChatMessage(@Nonnull UUID chatId, @Nonnull String xAuthorization, @Nonnull String body)
+List<Object> sendChatMessage(@Nonnull UUID chatId, @Nonnull String xAuthorization, @Nonnull Object body, @Nullable String acceptLanguage)
 ```
 
 **POST** `/api/ai/chats/{chatId}/messages`
@@ -117,7 +117,8 @@ sendChatMessage
 |------------- | ------------- | ------------- | -------------|
 | **chatId** | **UUID** |  | |
 | **xAuthorization** | **String** |  | |
-| **body** | **String** |  | |
+| **body** | **Object** |  | |
+| **acceptLanguage** | **String** |  | [optional] |
 
 ### Return type
 

paas/docs/AiDeviceDashboardControllerApi.md

@@ -0,0 +1,32 @@
+# AiDeviceDashboardControllerApi
+
+`ThingsboardClient` methods:
+
+```
+com.fasterxml.jackson.databind.JsonNode generateDashboard(@Nonnull UUID deviceId, @Nonnull String xAuthorization, @Nonnull Object body) // generateDashboard
+```
+
+
+## generateDashboard
+
+```
+com.fasterxml.jackson.databind.JsonNode generateDashboard(@Nonnull UUID deviceId, @Nonnull String xAuthorization, @Nonnull Object body)
+```
+
+**POST** `/api/ai/devices/{deviceId}/dashboard`
+
+generateDashboard
+
+
+### Parameters
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **deviceId** | **UUID** |  | |
+| **xAuthorization** | **String** |  | |
+| **body** | **Object** |  | |
+
+### Return type
+
+**com.fasterxml.jackson.databind.JsonNode**
+

paas/docs/Alarm.md

@@ -10,7 +10,7 @@
 | **id** | **AlarmId** | JSON object with the alarm Id. Specify this field to update the alarm. Referencing non-existing alarm Id will cause error. Omit this field to create new alarm. | [optional] |
 | **createdTime** | **Long** | Timestamp of the alarm creation, in milliseconds | [optional] [readonly] |
 | **tenantId** | **TenantId** | JSON object with Tenant Id | [optional] [readonly] |
-| **customerId** | **CustomerId** | JSON object with Customer Id | [optional] [readonly] |
+| **customerId** | **CustomerId** | JSON object with Customer Id. Derived from the originator entity owner and cannot be set independently; any value supplied in the request body must match the originator's customer or the request is rejected. | [optional] [readonly] |
 | **type** | **String** | representing type of the Alarm | |
 | **originator** | **EntityId** | JSON object with alarm originator id | |
 | **severity** | **AlarmSeverity** | Alarm severity | |

paas/docs/AlarmControllerApi.md

@@ -370,7 +370,7 @@ Alarm saveAlarm(@Nonnull Alarm alarm)
 
 Create or Update Alarm (saveAlarm)
 
-Creates or Updates the Alarm. When creating alarm, platform generates Alarm Id as [time-based UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address)). The newly created Alarm id will be present in the response. Specify existing Alarm id to update the alarm. Referencing non-existing Alarm Id will cause 'Not Found' error.   Platform also deduplicate the alarms based on the entity id of originator and alarm 'type'. For example, if the user or system component create the alarm with the type 'HighTemperature' for device 'Device A' the new active alarm is created. If the user tries to create 'HighTemperature' alarm for the same device again, the previous alarm will be updated (the 'end_ts' will be set to current timestamp). If the user clears the alarm (see 'Clear Alarm(clearAlarm)'), than new alarm with the same type and same device may be created. Remove 'id', 'tenantId' and optionally 'customerId' from the request body example (below) to create new Alarm entity.   Available for users with 'TENANT_ADMIN' or 'CUSTOMER_USER' authority. Security check is performed to verify that the user has 'WRITE' permission for the entity (entities).
+Creates or Updates the Alarm. When creating alarm, platform generates Alarm Id as [time-based UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address)). The newly created Alarm id will be present in the response. Specify existing Alarm id to update the alarm. Referencing non-existing Alarm Id will cause 'Not Found' error.   Platform also deduplicate the alarms based on the entity id of originator and alarm 'type'. For example, if the user or system component create the alarm with the type 'HighTemperature' for device 'Device A' the new active alarm is created. If the user tries to create 'HighTemperature' alarm for the same device again, the previous alarm will be updated (the 'end_ts' will be set to current timestamp). If the user clears the alarm (see 'Clear Alarm(clearAlarm)'), than new alarm with the same type and same device may be created. Remove 'id', 'tenantId' and optionally 'customerId' from the request body example (below) to create new Alarm entity.   The alarm originator is an immutable routing key: when updating an existing alarm, the 'originator' in the request body must match the stored alarm's originator. A request that references an existing alarm id but carries a different originator is treated as a lookup miss and causes a 'Not Found' error.   Available for users with 'TENANT_ADMIN' or 'CUSTOMER_USER' authority. Security check is performed to verify that the user has 'WRITE' permission for the entity (entities).
 
 
 ### Parameters

paas/docs/AlarmData.md

@@ -10,7 +10,7 @@
 | **id** | **AlarmId** | JSON object with the alarm Id. Specify this field to update the alarm. Referencing non-existing alarm Id will cause error. Omit this field to create new alarm. | [optional] |
 | **createdTime** | **Long** | Timestamp of the alarm creation, in milliseconds | [optional] [readonly] |
 | **tenantId** | **TenantId** | JSON object with Tenant Id | [optional] [readonly] |
-| **customerId** | **CustomerId** | JSON object with Customer Id | [optional] [readonly] |
+| **customerId** | **CustomerId** | JSON object with Customer Id. Derived from the originator entity owner and cannot be set independently; any value supplied in the request body must match the originator's customer or the request is rejected. | [optional] [readonly] |
 | **type** | **String** | representing type of the Alarm | |
 | **originator** | **EntityId** | JSON object with alarm originator id | |
 | **severity** | **AlarmSeverity** | Alarm severity | |

paas/docs/AlarmInfo.md

@@ -10,7 +10,7 @@
 | **id** | **AlarmId** | JSON object with the alarm Id. Specify this field to update the alarm. Referencing non-existing alarm Id will cause error. Omit this field to create new alarm. | [optional] |
 | **createdTime** | **Long** | Timestamp of the alarm creation, in milliseconds | [optional] [readonly] |
 | **tenantId** | **TenantId** | JSON object with Tenant Id | [optional] [readonly] |
-| **customerId** | **CustomerId** | JSON object with Customer Id | [optional] [readonly] |
+| **customerId** | **CustomerId** | JSON object with Customer Id. Derived from the originator entity owner and cannot be set independently; any value supplied in the request body must match the originator's customer or the request is rejected. | [optional] [readonly] |
 | **type** | **String** | representing type of the Alarm | |
 | **originator** | **EntityId** | JSON object with alarm originator id | |
 | **severity** | **AlarmSeverity** | Alarm severity | |

paas/docs/Asset.md

@@ -11,7 +11,7 @@
 | **createdTime** | **Long** | Timestamp of the asset creation, in milliseconds | [optional] [readonly] |
 | **additionalInfo** | **com.fasterxml.jackson.databind.JsonNode** | Additional parameters of the asset. May include: 'description' (string). | [optional] |
 | **tenantId** | **TenantId** | JSON object with Tenant Id. | [optional] [readonly] |
-| **customerId** | **CustomerId** | JSON object with Customer Id. Use 'assignAssetToCustomer' to change the Customer Id. | [optional] [readonly] |
+| **customerId** | **CustomerId** | JSON object with Customer Id. Optional on create: when omitted, defaults to the owner of the target Entity Group or to the current Customer user. Cannot be changed on update via this endpoint; use the Owner API (changeOwnerToCustomer) to re-assign an existing Asset. | [optional] |
 | **name** | **String** | Unique Asset Name in scope of Tenant | |
 | **type** | **String** | Asset type | [optional] |
 | **label** | **String** | Label that may be used in widgets | [optional] |

paas/docs/AssetControllerApi.md

@@ -88,7 +88,7 @@ Returns a page of asset info objects owned by the tenant or the customer of a cu
 |------------- | ------------- | ------------- | -------------|
 | **pageSize** | **Integer** | Maximum amount of entities in a one page | |
 | **page** | **Integer** | Sequence number of page starting from 0 | |
-| **includeCustomers** | **Boolean** | Include customer or sub-customer entities | [optional] |
+| **includeCustomers** | **Boolean** | Include customer or sub-customer entities. For tenant administrator: when true, includes entities for all customers; when false (default), only own entities are returned. For customer user: when true, includes entities for all sub-customers. | [optional] |
 | **assetProfileId** | **String** | A string value representing the asset profile id. For example, '784f394c-42b6-435a-983c-b7beff2784f9' | [optional] |
 | **textSearch** | **String** | The case insensitive 'substring' filter based on the asset name. | [optional] |
 | **sortProperty** | **String** | Property of entity to sort by | [optional] [enum: createdTime, name, type, label, customerTitle] |
@@ -237,7 +237,7 @@ Returns a page of asset info objects owned by the specified customer. Asset Info
 | **customerId** | **String** | A string value representing the customer id. For example, '784f394c-42b6-435a-983c-b7beff2784f9' | |
 | **pageSize** | **Integer** | Maximum amount of entities in a one page | |
 | **page** | **Integer** | Sequence number of page starting from 0 | |
-| **includeCustomers** | **Boolean** | Include customer or sub-customer entities | [optional] |
+| **includeCustomers** | **Boolean** | Include customer or sub-customer entities. For tenant administrator: when true, includes entities for all customers; when false (default), only own entities are returned. For customer user: when true, includes entities for all sub-customers. | [optional] |
 | **assetProfileId** | **String** | A string value representing the asset profile id. For example, '784f394c-42b6-435a-983c-b7beff2784f9' | [optional] |
 | **textSearch** | **String** | The case insensitive 'substring' filter based on the asset name. | [optional] |
 | **sortProperty** | **String** | Property of entity to sort by | [optional] [enum: createdTime, name, type, label, customerTitle] |

paas/docs/AssetInfo.md

@@ -11,7 +11,7 @@
 | **createdTime** | **Long** | Timestamp of the asset creation, in milliseconds | [optional] [readonly] |
 | **additionalInfo** | **com.fasterxml.jackson.databind.JsonNode** | Additional parameters of the asset. May include: 'description' (string). | [optional] |
 | **tenantId** | **TenantId** | JSON object with Tenant Id. | [optional] [readonly] |
-| **customerId** | **CustomerId** | JSON object with Customer Id. Use 'assignAssetToCustomer' to change the Customer Id. | [optional] [readonly] |
+| **customerId** | **CustomerId** | JSON object with Customer Id. Optional on create: when omitted, defaults to the owner of the target Entity Group or to the current Customer user. Cannot be changed on update via this endpoint; use the Owner API (changeOwnerToCustomer) to re-assign an existing Asset. | [optional] |
 | **name** | **String** | Unique Asset Name in scope of Tenant | |
 | **type** | **String** | Asset type | [optional] |
 | **label** | **String** | Label that may be used in widgets | [optional] |

paas/docs/AvailableEntityKeys.md

@@ -10,8 +10,8 @@ Contains unique time series and attribute key names discovered from entities mat
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
 | **entityTypes** | **Set\<EntityType\>** | Set of entity types found among the matched entities. | |
-| **timeseries** | **Set\<String\>** |  | |
-| **attribute** | **Set\<String\>** |  | |
+| **timeseries** | **Set\<String\>** | List of unique time series key names available on the matched entities. | |
+| **attribute** | **Set\<String\>** | List of unique attribute key names available on the matched entities. | |