Update CE OpenAPI spec in master (from master)

ViacheslavKlimov · ViacheslavKlimov · commit baff51fd5d68 · 2026-05-21T16:19:22.000+01:00
diff --git a/ce/docs/AvailableEntityKeys.md b/ce/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. | |
 
 
 
diff --git a/ce/docs/AvailableEntityKeysV2.md b/ce/docs/AvailableEntityKeysV2.md
@@ -10,7 +10,7 @@ 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** | **List\<KeyInfo\>** |  | [optional] |
+| **timeseries** | **List\<KeyInfo\>** | List of unique time series keys available on the matched entities, sorted alphabetically. Omitted when timeseries keys were not requested. | [optional] |
 | **attributes** | **Map\<String, List<KeyInfo>\>** | Map of attribute scope to the list of unique attribute keys available on the matched entities. Only scopes supported by the matched entity types are included. Omitted when attribute keys were not requested or when none of the requested scopes apply to the matched entity types. | [optional] |
 
 
diff --git a/ce/docs/EntityDataDiff.md b/ce/docs/EntityDataDiff.md
@@ -74,7 +74,7 @@
 #### WidgetsBundleExportData  *(extends EntityExportData, entityType=`WIDGETS_BUNDLE`)*
 | Name | Type | Description | Notes |
 |------|------|-------------|-------|
-| widgets | List<com.fasterxml.jackson.databind.JsonNode> |  | [optional] |
+| widgets | List<com.fasterxml.jackson.databind.JsonNode> | List of widgets in the bundle | [optional] |
 | fqns | List<String> |  | [optional] |
 
 #### WidgetTypeExportData  *(extends EntityExportData, entityType=`WIDGET_TYPE`)*
diff --git a/ce/docs/EntityExportData.md b/ce/docs/EntityExportData.md
@@ -68,7 +68,7 @@ Base export container for ThingsBoard entities
 #### WidgetsBundleExportData  *(entityType=`WIDGETS_BUNDLE`)*
 | Name | Type | Description | Notes |
 |------|------|-------------|-------|
-| widgets | List<com.fasterxml.jackson.databind.JsonNode> |  | [optional] |
+| widgets | List<com.fasterxml.jackson.databind.JsonNode> | List of widgets in the bundle | [optional] |
 | fqns | List<String> |  | [optional] |
 
 #### WidgetTypeExportData  *(entityType=`WIDGET_TYPE`)*
diff --git a/ce/docs/TbChatRequest.md b/ce/docs/TbChatRequest.md
@@ -18,7 +18,7 @@
 #### TbUserMessage
 | Name | Type | Description | Notes |
 |------|------|-------------|-------|
-| contents | List<TbContent> |  |  |
+| contents | List<TbContent> | A list of content parts that make up the complete user prompt |  |
 
 #### AiModelConfig
 | Name | Type | Description | Notes |
diff --git a/ce/docs/TbUserMessage.md b/ce/docs/TbUserMessage.md
@@ -7,7 +7,7 @@
 
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
-| **contents** | **List\<TbContent\>** |  | |
+| **contents** | **List\<TbContent\>** | A list of content parts that make up the complete user prompt | |
 
 
 
diff --git a/ce/docs/WidgetsBundleExportData.md b/ce/docs/WidgetsBundleExportData.md
@@ -9,7 +9,7 @@
 
 | Name | Type | Description | Notes |
 |------------ | ------------- | ------------- | -------------|
-| **widgets** | **List\<com.fasterxml.jackson.databind.JsonNode\>** |  | [optional] |
+| **widgets** | **List\<com.fasterxml.jackson.databind.JsonNode\>** | List of widgets in the bundle | [optional] |
 | **fqns** | **List\<String\>** |  | [optional] |
 
 
diff --git a/ce/spec/openapi.json b/ce/spec/openapi.json
@@ -85011,6 +85011,7 @@
           },
           "timeseries": {
             "type": "array",
+            "description": "List of unique time series key names available on the matched entities.",
             "items": {
               "type": "string",
               "example": "temperature",
@@ -85020,6 +85021,7 @@
           },
           "attribute": {
             "type": "array",
+            "description": "List of unique attribute key names available on the matched entities.",
             "items": {
               "type": "string",
               "example": "serialNumber",
@@ -85052,6 +85054,7 @@
           },
           "timeseries": {
             "type": "array",
+            "description": "List of unique time series keys available on the matched entities, sorted alphabetically.\nOmitted when timeseries keys were not requested.",
             "items": {
               "$ref": "#/components/schemas/KeyInfo"
             }
@@ -99631,6 +99634,7 @@
         "properties": {
           "contents": {
             "type": "array",
+            "description": "A list of content parts that make up the complete user prompt",
             "items": {
               "$ref": "#/components/schemas/TbContent"
             },
@@ -101793,6 +101797,7 @@
             "properties": {
               "widgets": {
                 "type": "array",
+                "description": "List of widgets in the bundle",
                 "items": {
                   "$ref": "#/components/schemas/JsonNode"
                 }
diff --git a/ce/src/main/java/org/thingsboard/client/model/AvailableEntityKeys.java b/ce/src/main/java/org/thingsboard/client/model/AvailableEntityKeys.java
@@ -109,7 +109,7 @@ public AvailableEntityKeys addTimeseriesItem(String timeseriesItem) {
   }
 
   /**
-   * Get timeseries
+   * List of unique time series key names available on the matched entities.
    * @return timeseries
    */
   @Nonnull
@@ -142,7 +142,7 @@ public AvailableEntityKeys addAttributeItem(String attributeItem) {
   }
 
   /**
-   * Get attribute
+   * List of unique attribute key names available on the matched entities.
    * @return attribute
    */
   @Nonnull
diff --git a/ce/src/main/java/org/thingsboard/client/model/AvailableEntityKeysV2.java b/ce/src/main/java/org/thingsboard/client/model/AvailableEntityKeysV2.java
@@ -115,7 +115,7 @@ public AvailableEntityKeysV2 addTimeseriesItem(KeyInfo timeseriesItem) {
   }
 
   /**
-   * Get timeseries
+   * List of unique time series keys available on the matched entities, sorted alphabetically. Omitted when timeseries keys were not requested.
    * @return timeseries
    */
   @Nullable
diff --git a/ce/src/main/java/org/thingsboard/client/model/TbUserMessage.java b/ce/src/main/java/org/thingsboard/client/model/TbUserMessage.java
@@ -65,7 +65,7 @@ public TbUserMessage addContentsItem(TbContent contentsItem) {
   }
 
   /**
-   * Get contents
+   * A list of content parts that make up the complete user prompt
    * @return contents
    */
   @Nonnull
diff --git a/ce/src/main/java/org/thingsboard/client/model/WidgetsBundleExportData.java b/ce/src/main/java/org/thingsboard/client/model/WidgetsBundleExportData.java
@@ -87,7 +87,7 @@ public WidgetsBundleExportData addWidgetsItem(com.fasterxml.jackson.databind.Jso
   }
 
   /**
-   * Get widgets
+   * List of widgets in the bundle
    * @return widgets
    */
   @Nullable

Original file line number	Diff line number	Diff line change
`@@ -115,7 +115,7 @@ public AvailableEntityKeysV2 addTimeseriesItem(KeyInfo timeseriesItem) {`
`115`	`115`	`}`
`116`	`116`
`117`	`117`	`/**`
`118`		`- * Get timeseries`
	`118`	`+ * List of unique time series keys available on the matched entities, sorted alphabetically. Omitted when timeseries keys were not requested.`
`119`	`119`	`* @return timeseries`
`120`	`120`	`*/`
`121`	`121`	`@Nullable`