rest-api-spec: Omit params and path parts if empty (elastic#136641) (elastic#137108)

pquentin · web-flow · commit 430adb51b9d5 · 2025-10-24T19:27:08.000+04:00
(cherry picked from commit 466309e) # Conflicts: # rest-api-spec/src/main/resources/rest-api-spec/api/security.get_stats.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/clear_scroll.json b/rest-api-spec/src/main/resources/rest-api-spec/api/clear_scroll.json
@@ -42,7 +42,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "A comma-separated list of scroll IDs to clear if none was specified via the scroll_id parameter",
       "required": false
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/close_point_in_time.json b/rest-api-spec/src/main/resources/rest-api-spec/api/close_point_in_time.json
@@ -24,7 +24,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "a point-in-time id to close",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.info.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.info.json
@@ -33,7 +33,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.remote_info.json b/rest-api-spec/src/main/resources/rest-api-spec/api/cluster.remote_info.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_delete.json b/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_delete.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_get.json b/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_get.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_post.json b/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_post.json
@@ -21,7 +21,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The secret value to store",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_put.json b/rest-api-spec/src/main/resources/rest-api-spec/api/connector.secret_put.json
@@ -27,7 +27,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The secret value to store",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/dangling_indices.list_dangling_indices.json b/rest-api-spec/src/main/resources/rest-api-spec/api/dangling_indices.list_dangling_indices.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.delete_secret.json b/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.delete_secret.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.get_secret.json b/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.get_secret.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.msearch.json b/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.msearch.json
@@ -38,7 +38,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The request definitions (metadata-fleet search request definition pairs), separated by newlines",
       "required": true,
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.post_secret.json b/rest-api-spec/src/main/resources/rest-api-spec/api/fleet.post_secret.json
@@ -21,7 +21,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The secret value to store",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/get_script_context.json b/rest-api-spec/src/main/resources/rest-api-spec/api/get_script_context.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/get_script_languages.json b/rest-api-spec/src/main/resources/rest-api-spec/api/get_script_languages.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.get_status.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.get_status.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.move_to_step.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.move_to_step.json
@@ -30,7 +30,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The new lifecycle step to move to",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.remove_policy.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.remove_policy.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.retry.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ilm.retry.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.downsample.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.downsample.json
@@ -36,7 +36,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The downsampling configuration",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.modify_data_stream.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.modify_data_stream.json
@@ -24,7 +24,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The data stream modifications",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/info.json b/rest-api-spec/src/main/resources/rest-api-spec/api/info.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_geoip_database.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_geoip_database.json
@@ -32,7 +32,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_ip_location_database.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.get_ip_location_database.json
@@ -32,7 +32,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.processor_grok.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ingest.processor_grok.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/license.get_basic_status.json b/rest-api-spec/src/main/resources/rest-api-spec/api/license.get_basic_status.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/license.get_trial_status.json b/rest-api-spec/src/main/resources/rest-api-spec/api/license.get_trial_status.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/logstash.delete_pipeline.json b/rest-api-spec/src/main/resources/rest-api-spec/api/logstash.delete_pipeline.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/logstash.get_pipeline.json b/rest-api-spec/src/main/resources/rest-api-spec/api/logstash.get_pipeline.json
@@ -32,7 +32,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/logstash.put_pipeline.json b/rest-api-spec/src/main/resources/rest-api-spec/api/logstash.put_pipeline.json
@@ -30,7 +30,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The Pipeline to add or update",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/migration.deprecations.json b/rest-api-spec/src/main/resources/rest-api-spec/api/migration.deprecations.json
@@ -32,7 +32,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/migration.get_feature_upgrade_status.json b/rest-api-spec/src/main/resources/rest-api-spec/api/migration.get_feature_upgrade_status.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/migration.post_feature_upgrade.json b/rest-api-spec/src/main/resources/rest-api-spec/api/migration.post_feature_upgrade.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.estimate_model_memory.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.estimate_model_memory.json
@@ -24,7 +24,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The analysis config, plus cardinality estimates for fields it references",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.explain_data_frame_analytics.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.explain_data_frame_analytics.json
@@ -21,8 +21,7 @@
           "methods": [
             "GET",
             "POST"
-          ],
-          "parts": {}
+          ]
         },
         {
           "path": "/_ml/data_frame/analytics/{id}/_explain",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.preview_data_frame_analytics.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.preview_data_frame_analytics.json
@@ -21,8 +21,7 @@
           "methods": [
             "GET",
             "POST"
-          ],
-          "parts": {}
+          ]
         },
         {
           "path": "/_ml/data_frame/analytics/{id}/_preview",
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.update_model_snapshot.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.update_model_snapshot.json
@@ -34,7 +34,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The model snapshot properties to update",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate.json
@@ -24,7 +24,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The job config",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate_detector.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ml.validate_detector.json
@@ -24,7 +24,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The detector",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ping.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ping.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json b/rest-api-spec/src/main/resources/rest-api-spec/api/scripts_painless_execute.json
@@ -25,7 +25,6 @@
         }
       ]
     },
-    "params": {},
     "body": {
       "description": "The script to execute",
       "required": true
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.authenticate.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.authenticate.json
@@ -20,7 +20,6 @@
           ]
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_api_key_cache.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_api_key_cache.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_cached_privileges.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_cached_privileges.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_cached_roles.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_cached_roles.json
@@ -26,7 +26,6 @@
           }
         }
       ]
-    },
-    "params": {}
+    }
   }
 }
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_cached_service_tokens.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.clear_cached_service_tokens.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.create_cross_cluster_api_key.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.create_cross_cluster_api_key.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.delegate_pki.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.delegate_pki.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_builtin_privileges.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_builtin_privileges.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_privileges.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_privileges.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_role.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_role.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_role_mapping.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_role_mapping.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_service_accounts.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_service_accounts.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_service_credentials.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_service_credentials.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_token.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_token.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_user_privileges.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.get_user_privileges.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.has_privileges.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.has_privileges.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.has_privileges_user_profile.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.has_privileges_user_profile.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/security.invalidate_token.json b/rest-api-spec/src/main/resources/rest-api-spec/api/security.invalidate_token.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/shutdown.get_node.json b/rest-api-spec/src/main/resources/rest-api-spec/api/shutdown.get_node.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/sql.translate.json b/rest-api-spec/src/main/resources/rest-api-spec/api/sql.translate.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/ssl.certificates.json b/rest-api-spec/src/main/resources/rest-api-spec/api/ssl.certificates.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/terms_enum.json b/rest-api-spec/src/main/resources/rest-api-spec/api/terms_enum.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/watcher.get_watch.json b/rest-api-spec/src/main/resources/rest-api-spec/api/watcher.get_watch.json
diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/watcher.query_watches.json b/rest-api-spec/src/main/resources/rest-api-spec/api/watcher.query_watches.json

Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,6 @@`
`42`	`42`	`}`
`43`	`43`	`]`
`44`	`44`	`},`
`45`		`- "params": {},`
`46`	`45`	`"body": {`
`47`	`46`	`"description": "A comma-separated list of scroll IDs to clear if none was specified via the scroll_id parameter",`
`48`	`47`	`"required": false`
Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,6 @@`
`24`	`24`	`}`
`25`	`25`	`]`
`26`	`26`	`},`
`27`		`- "params": {},`
`28`	`27`	`"body": {`
`29`	`28`	`"description": "a point-in-time id to close",`
`30`	`29`	`"required": true`
Original file line number	Diff line number	Diff line change
`@@ -33,7 +33,6 @@`
`33`	`33`	`}`
`34`	`34`	`}`
`35`	`35`	`]`
`36`		`- },`
`37`		`- "params": {}`
	`36`	`+ }`
`38`	`37`	`}`
`39`	`38`	`}`
Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,6 @@`
`20`	`20`	`]`
`21`	`21`	`}`
`22`	`22`	`]`
`23`		`- },`
`24`		`- "params": {}`
	`23`	`+ }`
`25`	`24`	`}`
`26`	`25`	`}`
Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,6 @@`
`26`	`26`	`}`
`27`	`27`	`}`
`28`	`28`	`]`
`29`		`- },`
`30`		`- "params": {}`
	`29`	`+ }`
`31`	`30`	`}`
`32`	`31`	`}`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,6 @@`
`21`	`21`	`}`
`22`	`22`	`]`
`23`	`23`	`},`
`24`		`- "params": {},`
`25`	`24`	`"body": {`
`26`	`25`	`"description": "The secret value to store",`
`27`	`26`	`"required": true`
Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,6 @@`
`27`	`27`	`}`
`28`	`28`	`]`
`29`	`29`	`},`
`30`		`- "params": {},`
`31`	`30`	`"body": {`
`32`	`31`	`"description": "The secret value to store",`
`33`	`32`	`"required": true`