diff --git a/swagger/docs.go b/swagger/docs.go
index e736509e9747..c4791350ac49 100644
--- a/swagger/docs.go
+++ b/swagger/docs.go
@@ -2408,6 +2408,23 @@ const docTemplate = `{
                 }
             }
         },
+        "gallery.NodeDriftInfo": {
+            "type": "object",
+            "properties": {
+                "digest": {
+                    "type": "string"
+                },
+                "node_id": {
+                    "type": "string"
+                },
+                "node_name": {
+                    "type": "string"
+                },
+                "version": {
+                    "type": "string"
+                }
+            }
+        },
         "gallery.UpgradeInfo": {
             "type": "object",
             "properties": {
@@ -2425,6 +2442,13 @@ const docTemplate = `{
                 },
                 "installed_version": {
                     "type": "string"
+                },
+                "node_drift": {
+                    "description": "NodeDrift lists nodes whose installed version or digest differs from\nthe cluster majority. Non-empty means the cluster has diverged and an\nupgrade will realign it. Empty in single-node mode.",
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/gallery.NodeDriftInfo"
+                    }
                 }
             }
         },
diff --git a/swagger/swagger.json b/swagger/swagger.json
index 9d3b506e2f2e..c819c617161e 100644
--- a/swagger/swagger.json
+++ b/swagger/swagger.json
@@ -2405,6 +2405,23 @@
                 }
             }
         },
+        "gallery.NodeDriftInfo": {
+            "type": "object",
+            "properties": {
+                "digest": {
+                    "type": "string"
+                },
+                "node_id": {
+                    "type": "string"
+                },
+                "node_name": {
+                    "type": "string"
+                },
+                "version": {
+                    "type": "string"
+                }
+            }
+        },
         "gallery.UpgradeInfo": {
             "type": "object",
             "properties": {
@@ -2422,6 +2439,13 @@
                 },
                 "installed_version": {
                     "type": "string"
+                },
+                "node_drift": {
+                    "description": "NodeDrift lists nodes whose installed version or digest differs from\nthe cluster majority. Non-empty means the cluster has diverged and an\nupgrade will realign it. Empty in single-node mode.",
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/gallery.NodeDriftInfo"
+                    }
                 }
             }
         },
diff --git a/swagger/swagger.yaml b/swagger/swagger.yaml
index 9d51aa5d517b..06de43e663c8 100644
--- a/swagger/swagger.yaml
+++ b/swagger/swagger.yaml
@@ -157,6 +157,17 @@ definitions:
           type: string
         type: array
     type: object
+  gallery.NodeDriftInfo:
+    properties:
+      digest:
+        type: string
+      node_id:
+        type: string
+      node_name:
+        type: string
+      version:
+        type: string
+    type: object
   gallery.UpgradeInfo:
     properties:
       available_digest:
@@ -169,6 +180,14 @@ definitions:
         type: string
       installed_version:
         type: string
+      node_drift:
+        description: |-
+          NodeDrift lists nodes whose installed version or digest differs from
+          the cluster majority. Non-empty means the cluster has diverged and an
+          upgrade will realign it. Empty in single-node mode.
+        items:
+          $ref: '#/definitions/gallery.NodeDriftInfo'
+        type: array
     type: object
   galleryop.OpStatus:
     properties: