From 468489b3444c2e22167e0dc8daece5e21092c0e6 Mon Sep 17 00:00:00 2001
From: Pat Whelan <pat.whelan@elastic.co>
Date: Mon, 11 Aug 2025 12:21:23 -0400
Subject: [PATCH] [Transform] Upgrade Mode docs (#132652)

Create docs for Transform's upgrade mode

Relate #132510
---
 .../api/transform.set_upgrade_mode.json       | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 rest-api-spec/src/main/resources/rest-api-spec/api/transform.set_upgrade_mode.json

diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/transform.set_upgrade_mode.json b/rest-api-spec/src/main/resources/rest-api-spec/api/transform.set_upgrade_mode.json
new file mode 100644
index 0000000000000..3fe554e7b00f6
--- /dev/null
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/transform.set_upgrade_mode.json
@@ -0,0 +1,33 @@
+{
+  "transform.set_upgrade_mode":{
+    "documentation":{
+      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/transform-set-upgrade-mode.html",
+      "description":"Sets a cluster wide upgrade_mode setting that prepares transform indices for an upgrade."
+    },
+    "stability":"stable",
+    "visibility":"public",
+    "headers":{
+      "accept": [ "application/json"]
+    },
+    "url":{
+      "paths":[
+        {
+          "path":"/_transform/set_upgrade_mode",
+          "methods":[
+            "POST"
+          ]
+        }
+      ]
+    },
+    "params":{
+      "enabled":{
+        "type":"boolean",
+        "description":"Whether to enable upgrade_mode Transform setting or not. Defaults to false."
+      },
+      "timeout":{
+        "type":"time",
+        "description":"Controls the time to wait before action times out. Defaults to 30 seconds"
+      }
+    }
+  }
+}