From d00b792a84543267270f2401621f75d3e3d6dbcc Mon Sep 17 00:00:00 2001
From: Stephanie Hingtgen <stephanie.hingtgen@grafana.com>
Date: Wed, 30 Apr 2025 10:39:26 -0600
Subject: [PATCH] [release-12.0.0] Dashboard API: Update dashboard version docs
 (#104790)

Co-authored-by: Artur Wierzbicki <artur.wierzbicki@grafana.com>
---
 .../developers/http_api/dashboard_versions.md | 53 ++++++++++---------
 1 file changed, 28 insertions(+), 25 deletions(-)

diff --git a/docs/sources/developers/http_api/dashboard_versions.md b/docs/sources/developers/http_api/dashboard_versions.md
index ef25424bbc7..33b59b97e48 100644
--- a/docs/sources/developers/http_api/dashboard_versions.md
+++ b/docs/sources/developers/http_api/dashboard_versions.md
@@ -47,30 +47,33 @@ HTTP/1.1 200 OK
 Content-Type: application/json; charset=UTF-8
 Content-Length: 428
 
-[
-  {
-    "id": 2,
-    "dashboardId": 1,
-    "uid": "QA7wKklGz",
-    "parentVersion": 1,
-    "restoredFrom": 0,
-    "version": 2,
-    "created": "2017-06-08T17:24:33-04:00",
-    "createdBy": "admin",
-    "message": "Updated panel title"
-  },
-  {
-    "id": 1,
-    "dashboardId": 1,
-    "uid": "QA7wKklGz",
-    "parentVersion": 0,
-    "restoredFrom": 0,
-    "version": 1,
-    "created": "2017-06-08T17:23:33-04:00",
-    "createdBy": "admin",
-    "message": "Initial save"
-  }
-]
+{
+  "continueToken": "",
+  "versions": [
+    {
+      "id": 2,
+      "dashboardId": 1,
+      "uid": "QA7wKklGz",
+      "parentVersion": 1,
+      "restoredFrom": 0,
+      "version": 2,
+      "created": "2017-06-08T17:24:33-04:00",
+      "createdBy": "admin",
+      "message": "Updated panel title"
+    },
+    {
+      "id": 1,
+      "dashboardId": 1,
+      "uid": "QA7wKklGz",
+      "parentVersion": 0,
+      "restoredFrom": 0,
+      "version": 1,
+      "created": "2017-06-08T17:23:33-04:00",
+      "createdBy": "admin",
+      "message": "Initial save"
+    }
+  ]
+}
 ```
 
 Status Codes:
@@ -89,7 +92,7 @@ Get the dashboard version with the given version, for the dashboard with the giv
 **Example request for getting a dashboard version**:
 
 ```http
-GET /api/dashboards/id/1/versions/1 HTTP/1.1
+GET /api/dashboards/uid/QA7wKklGz/versions/1 HTTP/1.1
 Accept: application/json
 Content-Type: application/json
 Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk