diff --git a/rest-api-spec/api/cluster.node.shutdown.json b/rest-api-spec/api/cluster.node.shutdown.json
index 3a9d3146836..fa6a25f5f6f 100644
--- a/rest-api-spec/api/cluster.node.shutdown.json
+++ b/rest-api-spec/api/cluster.node.shutdown.json
@@ -7,12 +7,18 @@
       "paths": ["/_shutdown", "/_cluster/nodes/_shutdown", "/_cluster/nodes/{nodeId}/_shutdown"],
       "parts": {
         "nodeId": {
+          "type" : "list",
+          "description" : "A comma-separated list of nodes to limit the returned information"
         }
       },
       "params": {
         "delay": {
+          "type" : "time",
+          "description" : "Set the delay for the operation (default: 1s)"
         },
         "exit": {
+          "type" : "boolean",
+          "description" : "Exit the JVM as well (default: true)"
         }
       }
     },