elastic · joshua-adams-1 · Jul 15, 2025 · Jun 12, 2025 · Jun 13, 2025 · Jun 13, 2025
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.allocation_explain.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.allocation_explain.json
@@ -22,6 +22,22 @@
       ]
     },
     "params":{
+      "index": {
+        "type": "string",
+        "description": "Specifies the name of the index that you would like an explanation for"
+      },
+      "shard": {
+        "type": "number",
+        "description": "Specifies the ID of the shard that you would like an explanation for"
+      },
+      "primary": {
+        "type":"boolean",
+        "description":"If true, returns explanation for the primary shard for the given shard ID"
+      },
+      "current_node": {
+        "type": "string",
+        "description": "Specifies the node ID or the name of the node to only explain a shard that is currently located on the specified node"
+      },
       "master_timeout":{
         "type":"time",
         "description":"Timeout for connection to master node"