From 1e625c420c8c5b6de4263af4a33a1d637320f83d Mon Sep 17 00:00:00 2001
From: dashevchenko <dshevchenko@thingsboard.io>
Date: Wed, 18 Feb 2026 11:28:24 +0200
Subject: [PATCH] fixed values/timeseries api for case when key param is used
 instead of keys

---
 .../controller/TelemetryController.java       |  2 +-
 .../controller/TelemetryControllerTest.java   | 23 +++++++++++--------
 2 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/application/src/main/java/org/thingsboard/server/controller/TelemetryController.java b/application/src/main/java/org/thingsboard/server/controller/TelemetryController.java
index b0f5f41c9a..856b17fc61 100644
--- a/application/src/main/java/org/thingsboard/server/controller/TelemetryController.java
+++ b/application/src/main/java/org/thingsboard/server/controller/TelemetryController.java
@@ -284,7 +284,7 @@ public class TelemetryController extends BaseController {
                     + MARKDOWN_CODE_BLOCK_END
                     + "\n\n" + INVALID_ENTITY_ID_OR_ENTITY_TYPE_DESCRIPTION + TENANT_OR_CUSTOMER_AUTHORITY_PARAGRAPH)
     @PreAuthorize("hasAnyAuthority('SYS_ADMIN', 'TENANT_ADMIN', 'CUSTOMER_USER')")
-    @GetMapping(value = "/{entityType}/{entityId}/values/timeseries", params = {"keys", "startTs", "endTs"})
+    @GetMapping(value = "/{entityType}/{entityId}/values/timeseries", params = {"startTs", "endTs"})
     public DeferredResult<ResponseEntity> getTimeseries(
             @Parameter(description = ENTITY_TYPE_PARAM_DESCRIPTION, required = true, schema = @Schema(defaultValue = "DEVICE")) @PathVariable("entityType") String entityType,
             @Parameter(description = ENTITY_ID_PARAM_DESCRIPTION, required = true) @PathVariable("entityId") String entityIdStr,
diff --git a/application/src/test/java/org/thingsboard/server/controller/TelemetryControllerTest.java b/application/src/test/java/org/thingsboard/server/controller/TelemetryControllerTest.java
index dd51cdd440..ce6d291546 100644
--- a/application/src/test/java/org/thingsboard/server/controller/TelemetryControllerTest.java
+++ b/application/src/test/java/org/thingsboard/server/controller/TelemetryControllerTest.java
@@ -102,24 +102,29 @@ public class TelemetryControllerTest extends AbstractControllerTest {
         Assert.assertEquals(11L, thirdIntervalResult.get("value").asLong());
         Assert.assertEquals(thirdIntervalTs, thirdIntervalResult.get("ts").asLong());
 
-        result = doGetAsync("/api/plugins/telemetry/DEVICE/" + device.getId() +
+        ObjectNode resultByMonth = doGetAsync("/api/plugins/telemetry/DEVICE/" + device.getId() +
                         "/values/timeseries?keys=t&startTs={startTs}&endTs={endTs}&agg={agg}&intervalType={intervalType}&timeZone={timeZone}",
                 ObjectNode.class, startTs, endTs, "SUM", "MONTH", "Europe/Kyiv");
 
-        Assert.assertNotNull(result);
-        Assert.assertNotNull(result.get("t"));
-        Assert.assertEquals(1, result.get("t").size());
+        Assert.assertNotNull(resultByMonth);
+        Assert.assertNotNull(resultByMonth.get("t"));
+        Assert.assertEquals(1, resultByMonth.get("t").size());
 
-        var monthResult = result.get("t").get(0);
+        var monthResult = resultByMonth.get("t").get(0);
         Assert.assertEquals(22L, monthResult.get("value").asLong());
         Assert.assertEquals(middleOfTheInterval, monthResult.get("ts").asLong());
 
-        // get all latest (without keys parameter)
-        ObjectNode allLatest = doGetAsync("/api/plugins/telemetry/DEVICE/" + device.getId() +
+        // check timeseries history with key parameter (instead of keys) has the same result as with keys parameter
+        ObjectNode resultByKey = doGetAsync("/api/plugins/telemetry/DEVICE/" + device.getId() +
+                        "/values/timeseries?key=t&startTs={startTs}&endTs={endTs}&agg={agg}&intervalType={intervalType}&timeZone={timeZone}",
+                ObjectNode.class, startTs, endTs, "SUM", "WEEK_ISO", "Europe/Kyiv");
+        Assert.assertEquals(result, resultByKey);
+
+        // check timeseries history without keys and key results into empty object
+        ObjectNode resultWithoutKeyAndKeys = doGetAsync("/api/plugins/telemetry/DEVICE/" + device.getId() +
                         "/values/timeseries?startTs={startTs}&endTs={endTs}&agg={agg}&intervalType={intervalType}&timeZone={timeZone}",
                 ObjectNode.class, startTs, endTs, "SUM", "WEEK_ISO", "Europe/Kyiv");
-        Assert.assertNotNull(allLatest);
-        Assert.assertNotNull(allLatest.get("t"));
+        Assert.assertTrue(resultWithoutKeyAndKeys.isEmpty());
     }
 
     @Test