Merge pull request #51 from thingsboard/auto/update-pe-client-master

Update PE OpenAPI spec (from master)

Author: ViacheslavKlimov

pe/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 String 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 String body, @Nullable String acceptLanguage)
 ```
 
 **POST** `/api/ai/chats/{chatId}/messages`
@@ -118,6 +118,7 @@ sendChatMessage
 | **chatId** | **UUID** |  | |
 | **xAuthorization** | **String** |  | |
 | **body** | **String** |  | |
+| **acceptLanguage** | **String** |  | [optional] |
 
 ### Return type
 

pe/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**
+

pe/docs/EntityDataDiff.md

@@ -54,9 +54,10 @@
 #### EntityGroupExportData  *(extends EntityExportData, entityType=`ENTITY_GROUP`)*
 | Name | Type | Description | Notes |
 |------|------|-------------|-------|
-| permissions | List<GroupPermission> |  | [optional] |
-| groupOtaPackages | List<DeviceGroupOtaPackage> |  | [optional] |
-| groupEntities | Boolean |  | [optional] |
+| permissions | List<GroupPermission> | Group permissions to apply to this group on import. Meaningful only for USER groups; ignored for groups of any other type. Each entry's userGroupId, roleId, and entityGroupId may use the external IDs of other entities in this payload or the IDs of entities that already exist on the target tenant; the importer resolves them against the target tenant. System-tenant roles are not allowed and will be rejected. Leave null to skip permission management for this group. | [optional] |
+| groupOtaPackages | List<DeviceGroupOtaPackage> | OTA package assignments to apply to this group on import. Meaningful only for DEVICE groups; ignored for groups of any other type. Each entry's otaPackageId and groupId may reference external IDs of entities in this payload or IDs of entities that already exist on the target tenant. Leave null to skip OTA assignment management for this group. | [optional] |
+| groupEntities | Boolean | Marker indicating that the group's member entities are intended to be transported alongside this payload. Used by flows that convey members through a side channel (notably the version control flow, which stores members in a separate git index). The solution import API does not consume this flag and does not require it to be set. Safe to leave false (default). | [optional] |
+| memberIds | List<UUID> | External IDs of the entities that should be members of this group after import. Each ID is resolved against the target tenant — by other entity in this payload, by external ID, or by existing internal ID — and the matching entities are added to the group. The import fails if any listed member cannot be resolved. Must be null for the special 'All' group (whose membership is implicit and managed by the platform). Leave null to skip membership wiring; existing membership on the target tenant is left untouched. | [optional] |
 
 #### EntityViewExportData  *(extends EntityExportData, entityType=`ENTITY_VIEW`)*
 *See EntityExportData for properties.*
@@ -93,6 +94,9 @@
 #### TbResourceExportData  *(extends EntityExportData, entityType=`TB_RESOURCE`)*
 *See EntityExportData for properties.*
 
+#### UserExportData  *(extends EntityExportData, entityType=`USER`)*
+*See EntityExportData for properties.*
+
 #### WidgetsBundleExportData  *(extends EntityExportData, entityType=`WIDGETS_BUNDLE`)*
 | Name | Type | Description | Notes |
 |------|------|-------------|-------|

pe/docs/EntityExportData.md

@@ -48,9 +48,10 @@ Base export container for ThingsBoard entities
 #### EntityGroupExportData  *(entityType=`ENTITY_GROUP`)*
 | Name | Type | Description | Notes |
 |------|------|-------------|-------|
-| permissions | List<GroupPermission> |  | [optional] |
-| groupOtaPackages | List<DeviceGroupOtaPackage> |  | [optional] |
-| groupEntities | Boolean |  | [optional] |
+| permissions | List<GroupPermission> | Group permissions to apply to this group on import. Meaningful only for USER groups; ignored for groups of any other type. Each entry's userGroupId, roleId, and entityGroupId may use the external IDs of other entities in this payload or the IDs of entities that already exist on the target tenant; the importer resolves them against the target tenant. System-tenant roles are not allowed and will be rejected. Leave null to skip permission management for this group. | [optional] |
+| groupOtaPackages | List<DeviceGroupOtaPackage> | OTA package assignments to apply to this group on import. Meaningful only for DEVICE groups; ignored for groups of any other type. Each entry's otaPackageId and groupId may reference external IDs of entities in this payload or IDs of entities that already exist on the target tenant. Leave null to skip OTA assignment management for this group. | [optional] |
+| groupEntities | Boolean | Marker indicating that the group's member entities are intended to be transported alongside this payload. Used by flows that convey members through a side channel (notably the version control flow, which stores members in a separate git index). The solution import API does not consume this flag and does not require it to be set. Safe to leave false (default). | [optional] |
+| memberIds | List<UUID> | External IDs of the entities that should be members of this group after import. Each ID is resolved against the target tenant — by other entity in this payload, by external ID, or by existing internal ID — and the matching entities are added to the group. The import fails if any listed member cannot be resolved. Must be null for the special 'All' group (whose membership is implicit and managed by the platform). Leave null to skip membership wiring; existing membership on the target tenant is left untouched. | [optional] |
 
 #### EntityViewExportData  *(entityType=`ENTITY_VIEW`)*
 *(no additional properties)*
@@ -87,6 +88,9 @@ Base export container for ThingsBoard entities
 #### TbResourceExportData  *(entityType=`TB_RESOURCE`)*
 *(no additional properties)*
 
+#### UserExportData  *(entityType=`USER`)*
+*(no additional properties)*
+
 #### WidgetsBundleExportData  *(entityType=`WIDGETS_BUNDLE`)*
 | Name | Type | Description | Notes |
 |------|------|-------------|-------|

pe/docs/EntityExportSettings.md

@@ -13,6 +13,7 @@
 | **exportCalculatedFields** | **Boolean** |  | [optional] |
 | **exportPermissions** | **Boolean** |  | [optional] |
 | **exportGroupEntities** | **Boolean** |  | [optional] |
+| **embedGroupMembers** | **Boolean** |  | [optional] |
 
 
 

pe/docs/EntityGroup.md

@@ -13,7 +13,7 @@ A JSON value representing the entity group.
 | **createdTime** | **Long** | Timestamp of the entity group creation, in milliseconds | [optional] [readonly] |
 | **type** | **TypeEnum** |  | |
 | **name** | **String** | Name of the entity group | |
-| **ownerId** | **EntityId** | JSON object with the owner of the group - Tenant or Customer Id. | [optional] |
+| **ownerId** | **EntityId** | JSON object with the owner of the group - Tenant or Customer Id. When omitted or null on creation, defaults to the current user's owner (Tenant for tenant admins, Customer for customer users). | [optional] |
 | **additionalInfo** | **com.fasterxml.jackson.databind.JsonNode** | Additional parameters of the entity group. May include: 'description' (string), 'isPublic' (boolean, whether this group is shared publicly), 'publicCustomerId' (string, UUID of the public customer associated with this group). | [optional] |
 | **_configuration** | **com.fasterxml.jackson.databind.JsonNode** | JSON with the configuration for UI components: list of columns, settings, actions, etc  | [optional] |
 | **version** | **Long** |  | [optional] |

pe/docs/EntityGroupExportData.md

@@ -9,9 +9,10 @@
 
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
-| **permissions** | **List\<GroupPermission\>** |  | [optional] |
-| **groupOtaPackages** | **List\<DeviceGroupOtaPackage\>** |  | [optional] |
-| **groupEntities** | **Boolean** |  | [optional] |
+| **permissions** | **List\<GroupPermission\>** | Group permissions to apply to this group on import. Meaningful only for USER groups; ignored for groups of any other type. Each entry's userGroupId, roleId, and entityGroupId may use the external IDs of other entities in this payload or the IDs of entities that already exist on the target tenant; the importer resolves them against the target tenant. System-tenant roles are not allowed and will be rejected. Leave null to skip permission management for this group. | [optional] |
+| **groupOtaPackages** | **List\<DeviceGroupOtaPackage\>** | OTA package assignments to apply to this group on import. Meaningful only for DEVICE groups; ignored for groups of any other type. Each entry's otaPackageId and groupId may reference external IDs of entities in this payload or IDs of entities that already exist on the target tenant. Leave null to skip OTA assignment management for this group. | [optional] |
+| **groupEntities** | **Boolean** | Marker indicating that the group's member entities are intended to be transported alongside this payload. Used by flows that convey members through a side channel (notably the version control flow, which stores members in a separate git index). The solution import API does not consume this flag and does not require it to be set. Safe to leave false (default). | [optional] |
+| **memberIds** | **List\<UUID\>** | External IDs of the entities that should be members of this group after import. Each ID is resolved against the target tenant — by other entity in this payload, by external ID, or by existing internal ID — and the matching entities are added to the group. The import fails if any listed member cannot be resolved. Must be null for the special 'All' group (whose membership is implicit and managed by the platform). Leave null to skip membership wiring; existing membership on the target tenant is left untouched. | [optional] |
 
 
 

pe/docs/EntityGroupInfo.md

@@ -11,7 +11,7 @@
 | **createdTime** | **Long** | Timestamp of the entity group creation, in milliseconds | [optional] [readonly] |
 | **type** | **TypeEnum** |  | |
 | **name** | **String** | Name of the entity group | |
-| **ownerId** | **EntityId** | JSON object with the owner of the group - Tenant or Customer Id. | [optional] |
+| **ownerId** | **EntityId** | JSON object with the owner of the group - Tenant or Customer Id. When omitted or null on creation, defaults to the current user's owner (Tenant for tenant admins, Customer for customer users). | [optional] |
 | **additionalInfo** | **com.fasterxml.jackson.databind.JsonNode** | Additional parameters of the entity group. May include: 'description' (string), 'isPublic' (boolean, whether this group is shared publicly), 'publicCustomerId' (string, UUID of the public customer associated with this group). | [optional] |
 | **_configuration** | **com.fasterxml.jackson.databind.JsonNode** | JSON with the configuration for UI components: list of columns, settings, actions, etc  | [optional] |
 | **version** | **Long** |  | [optional] |

pe/docs/GroupPermissionInfo.md

@@ -44,8 +44,8 @@
 | customerId | CustomerId | JSON object with Customer Id. | [optional] [readonly] |
 | name | String | Role Name |  |
 | type | RoleType | Type of the role: generic or group |  |
-| permissions | com.fasterxml.jackson.databind.JsonNode | JSON object with the set of permissions. Structure is specific for role type |  |
-| excludedPermissions | com.fasterxml.jackson.databind.JsonNode | JSON object with the set of excluded permissions. Only applicable for generic roles. Structure is the same as permissions | [optional] |
+| permissions | com.fasterxml.jackson.databind.JsonNode | Set of permissions granted by this role. The JSON shape depends on the role 'type':  * GENERIC — JSON object mapping `Resource` enum names to arrays of `Operation` enum names allowed on that resource. The wildcard entry `{\"ALL\":[\"ALL\"]}` grants every operation on every resource.  * GROUP — JSON array of `Operation` enum names that apply to the entity group this role is bound to via `GroupPermission.entityGroupId`. Only operations with `allowedForGroupRole=true` may appear (see `Operation` enum). The wildcard entry `[\"ALL\"]` grants every supported operation on the bound entity group. |  |
+| excludedPermissions | com.fasterxml.jackson.databind.JsonNode | Operations to subtract from those granted by `permissions`. Only applicable to GENERIC roles — setting this on a GROUP role is rejected by validation. Same shape as the GENERIC variant of `permissions`: a JSON object mapping `Resource` enum names to non-empty arrays of `Operation` enum names. At evaluation time, for each resource the listed operations are removed from the resolved permission set (e.g. `permissions={\"ALL\":[\"ALL\"]}` combined with `excludedPermissions={\"DEVICE\":[\"DELETE\"]}` grants everything except deleting devices). May be null or an empty object when no exclusions apply. | [optional] |
 | version | Long |  | [optional] |
 | ownerId | EntityId | JSON object with Customer or Tenant Id | [optional] [readonly] |
 

pe/docs/PageDataEntityGroupInfo.md

@@ -25,7 +25,7 @@
 | createdTime | Long | Timestamp of the entity group creation, in milliseconds | [optional] [readonly] |
 | type | TypeEnum |  |  |
 | name | String | Name of the entity group |  |
-| ownerId | EntityId | JSON object with the owner of the group - Tenant or Customer Id. | [optional] |
+| ownerId | EntityId | JSON object with the owner of the group - Tenant or Customer Id. When omitted or null on creation, defaults to the current user's owner (Tenant for tenant admins, Customer for customer users). | [optional] |
 | additionalInfo | com.fasterxml.jackson.databind.JsonNode | Additional parameters of the entity group. May include: 'description' (string), 'isPublic' (boolean, whether this group is shared publicly), 'publicCustomerId' (string, UUID of the public customer associated with this group). | [optional] |
 | _configuration | com.fasterxml.jackson.databind.JsonNode | JSON with the configuration for UI components: list of columns, settings, actions, etc | [optional] |
 | version | Long |  | [optional] |