Fix optional bodies (#5271) (#5272)

github-actions[bot] · pquentin · web-flow · commit 90f16d89b8a0 · 2025-09-10T16:25:57.000+04:00
* Fix optional bodies * Mark snapshot.create/snapshot.restore bodies as optional too (cherry picked from commit 3348b2f) Co-authored-by: Quentin Pradet <quentin.pradet@elastic.co>
diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
diff --git a/output/schema/schema.json b/output/schema/schema.json
diff --git a/output/typescript/types.ts b/output/typescript/types.ts
diff --git a/specification/_global/mtermvectors/MultiTermVectorsRequest.ts b/specification/_global/mtermvectors/MultiTermVectorsRequest.ts
@@ -121,7 +121,7 @@ export interface Request extends RequestBase {
      */
     version_type?: VersionType
   }
-  body: {
+  body?: {
     /**
      * An array of existing or artificial documents.
      */
diff --git a/specification/_global/search_mvt/SearchMvtRequest.ts b/specification/_global/search_mvt/SearchMvtRequest.ts
@@ -267,7 +267,7 @@ export interface Request extends RequestBase {
      */
     with_labels?: boolean
   }
-  body: {
+  body?: {
     /**
      * Sub-aggregations for the geotile_grid.
      *
diff --git a/specification/_global/termvectors/TermVectorsRequest.ts b/specification/_global/termvectors/TermVectorsRequest.ts
@@ -165,7 +165,7 @@ export interface Request<TDocument> extends RequestBase {
      */
     version_type?: VersionType
   }
-  body: {
+  body?: {
     /**
      * An artificial document (a document not present in the index) for which you want to retrieve term vectors.
      */
diff --git a/specification/async_search/submit/AsyncSearchSubmitRequest.ts b/specification/async_search/submit/AsyncSearchSubmitRequest.ts
@@ -158,7 +158,7 @@ export interface Request extends RequestBase {
     from?: integer
     sort?: string | string[]
   }
-  body: {
+  body?: {
     /** @aliases aggs */
     aggregations?: Dictionary<string, AggregationContainer>
     collapse?: FieldCollapse
diff --git a/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts b/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts
@@ -50,7 +50,7 @@ export interface Request extends RequestBase {
      */
     master_timeout?: Duration
   }
-  body: {
+  body?: {
     max_outstanding_read_requests?: long
     max_outstanding_write_requests?: long
     max_read_request_operation_count?: long
diff --git a/specification/ilm/migrate_to_data_tiers/Request.ts b/specification/ilm/migrate_to_data_tiers/Request.ts
@@ -54,7 +54,7 @@ export interface Request extends RequestBase {
      */
     dry_run?: boolean
   }
-  body: {
+  body?: {
     legacy_template_to_delete?: string
     node_attribute?: string
   }
diff --git a/specification/indices/create_from/MigrateCreateFromRequest.ts b/specification/indices/create_from/MigrateCreateFromRequest.ts
@@ -40,7 +40,7 @@ export interface Request extends RequestBase {
     dest: IndexName
   }
   /** @codegen_name create_from */
-  body: CreateFrom
+  body?: CreateFrom
 }
 
 export class CreateFrom {
diff --git a/specification/indices/put_alias/IndicesPutAliasRequest.ts b/specification/indices/put_alias/IndicesPutAliasRequest.ts
@@ -70,7 +70,7 @@ export interface Request extends RequestBase {
      */
     timeout?: Duration
   }
-  body: {
+  body?: {
     /**
      * Query used to limit documents the alias can access.
      */
diff --git a/specification/indices/simulate_index_template/IndicesSimulateIndexTemplateRequest.ts b/specification/indices/simulate_index_template/IndicesSimulateIndexTemplateRequest.ts
@@ -20,6 +20,7 @@
 import { RequestBase } from '@_types/Base'
 import { Name } from '@_types/common'
 import { Duration } from '@_types/Time'
+import { IndexTemplate } from '@indices/_types/IndexTemplate'
 
 /**
  * Simulate an index.
@@ -64,4 +65,6 @@ export interface Request extends RequestBase {
      */
     include_defaults?: boolean
   }
+  /** @codegen_name index_template */
+  body?: IndexTemplate
 }
diff --git a/specification/indices/simulate_template/IndicesSimulateTemplateRequest.ts b/specification/indices/simulate_template/IndicesSimulateTemplateRequest.ts
@@ -74,7 +74,7 @@ export interface Request extends RequestBase {
      */
     include_defaults?: boolean
   }
-  body: {
+  body?: {
     /**
      * This setting overrides the value of the `action.auto_create_index` cluster setting.
      * If set to `true` in a template, then indices can be automatically created using that template even if auto-creation of indices is disabled via `actions.auto_create_index`.
diff --git a/specification/ml/close_job/MlCloseJobRequest.ts b/specification/ml/close_job/MlCloseJobRequest.ts
@@ -66,7 +66,7 @@ export interface Request extends RequestBase {
      * @server_default 30m */
     timeout?: Duration
   }
-  body: {
+  body?: {
     /**
      * Refer to the description for the `allow_no_match` query parameter.
      * @server_default true
diff --git a/specification/ml/explain_data_frame_analytics/MlExplainDataFrameAnalyticsRequest.ts b/specification/ml/explain_data_frame_analytics/MlExplainDataFrameAnalyticsRequest.ts
@@ -62,7 +62,7 @@ export interface Request extends RequestBase {
      */
     id?: Id
   }
-  body: {
+  body?: {
     /**
      * The configuration of how to source the analysis data. It requires an
      * index. Optionally, query and _source may be specified.
diff --git a/specification/ml/forecast/MlForecastJobRequest.ts b/specification/ml/forecast/MlForecastJobRequest.ts
@@ -75,7 +75,7 @@ export interface Request extends RequestBase {
      */
     max_model_memory?: string
   }
-  body: {
+  body?: {
     /**
      * Refer to the description for the `duration` query parameter.
      * @server_default 1d
diff --git a/specification/ml/open_job/MlOpenJobRequest.ts b/specification/ml/open_job/MlOpenJobRequest.ts
@@ -57,7 +57,7 @@ export interface Request extends RequestBase {
      */
     timeout?: Duration
   }
-  body: {
+  body?: {
     /**
      * Refer to the description for the `timeout` query parameter.
      * @server_default 30m
diff --git a/specification/ml/preview_data_frame_analytics/MlPreviewDataFrameAnalyticsRequest.ts b/specification/ml/preview_data_frame_analytics/MlPreviewDataFrameAnalyticsRequest.ts
@@ -48,7 +48,7 @@ export interface Request extends RequestBase {
      */
     id?: Id
   }
-  body: {
+  body?: {
     /**
      * A data frame analytics config as described in create data frame analytics
      * jobs. Note that `id` and `dest` don’t need to be provided in the context of
diff --git a/specification/ml/preview_datafeed/MlPreviewDatafeedRequest.ts b/specification/ml/preview_datafeed/MlPreviewDatafeedRequest.ts
@@ -65,7 +65,7 @@ export interface Request extends RequestBase {
     start?: DateTime
     end?: DateTime
   }
-  body: {
+  body?: {
     /**
      * The datafeed definition to preview.
      */
diff --git a/specification/ml/put_calendar/MlPutCalendarRequest.ts b/specification/ml/put_calendar/MlPutCalendarRequest.ts
@@ -40,7 +40,7 @@ export interface Request extends RequestBase {
     /** A string that uniquely identifies a calendar. */
     calendar_id: Id
   }
-  body: {
+  body?: {
     /**
      * An array of anomaly detection job identifiers.
      */
diff --git a/specification/ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts b/specification/ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts
@@ -100,7 +100,7 @@ export interface Request extends RequestBase {
      */
     wait_for?: DeploymentAllocationState
   }
-  body: {
+  body?: {
     /**
      * Adaptive allocations configuration. When enabled, the number of allocations
      * is set based on the current load.
diff --git a/specification/ml/stop_datafeed/MlStopDatafeedRequest.ts b/specification/ml/stop_datafeed/MlStopDatafeedRequest.ts
@@ -69,7 +69,7 @@ export interface Request extends RequestBase {
      *  @server_default 20s */
     timeout?: Duration
   }
-  body: {
+  body?: {
     /**
      * Refer to the description for the `allow_no_match` query parameter.
      * @server_default true */
diff --git a/specification/ml/update_trained_model_deployment/MlUpdateTrainedModelDeploymentRequest.ts b/specification/ml/update_trained_model_deployment/MlUpdateTrainedModelDeploymentRequest.ts
@@ -56,7 +56,7 @@ export interface Request extends RequestBase {
      */
     number_of_allocations?: integer
   }
-  body: {
+  body?: {
     /**
      * The number of model allocations on each node where the model is deployed.
      * All allocations on a node share the same copy of the model in memory but use
diff --git a/specification/nodes/reload_secure_settings/ReloadSecureSettingsRequest.ts b/specification/nodes/reload_secure_settings/ReloadSecureSettingsRequest.ts
@@ -61,7 +61,7 @@ export interface Request extends RequestBase {
      */
     timeout?: Duration
   }
-  body: {
+  body?: {
     /**
      * The password for the Elasticsearch keystore.
      */
diff --git a/specification/search_application/render_query/SearchApplicationsRenderQueryRequest.ts b/specification/search_application/render_query/SearchApplicationsRenderQueryRequest.ts
@@ -48,7 +48,7 @@ export interface Request extends RequestBase {
   /**
    * Contains parameters for a search application.
    */
-  body: {
+  body?: {
     params?: Dictionary<string, UserDefinedValue>
   }
 }
diff --git a/specification/search_application/search/SearchApplicationsSearchRequest.ts b/specification/search_application/search/SearchApplicationsSearchRequest.ts
@@ -52,7 +52,7 @@ export interface Request extends RequestBase {
      */
     typed_keys?: boolean
   }
-  body: {
+  body?: {
     /**
      * Query parameters specific to this request, which will override any defaults specified in the template.
      */
diff --git a/specification/security/query_api_keys/QueryApiKeysRequest.ts b/specification/security/query_api_keys/QueryApiKeysRequest.ts
@@ -70,7 +70,7 @@ export interface Request extends RequestBase {
      */
     typed_keys?: boolean
   }
-  body: {
+  body?: {
     /**
      * Any aggregations to run over the corpus of returned API keys.
      * Aggregations and queries work together. Aggregations are computed only on the API keys that match the query.
diff --git a/specification/security/query_role/QueryRolesRequest.ts b/specification/security/query_role/QueryRolesRequest.ts
@@ -43,7 +43,7 @@ export interface Request extends RequestBase {
       methods: ['GET', 'POST']
     }
   ]
-  body: {
+  body?: {
     /**
      * A query to filter which roles to return.
      * If the query parameter is missing, it is equivalent to a `match_all` query.
diff --git a/specification/security/query_user/SecurityQueryUserRequest.ts b/specification/security/query_user/SecurityQueryUserRequest.ts
@@ -43,7 +43,7 @@ export interface Request extends RequestBase {
       methods: ['GET', 'POST']
     }
   ]
-  body: {
+  body?: {
     /**
      * A query to filter which users to return.
      * If the query parameter is missing, it is equivalent to a `match_all` query.
diff --git a/specification/security/suggest_user_profiles/Request.ts b/specification/security/suggest_user_profiles/Request.ts
@@ -52,7 +52,7 @@ export interface Request extends RequestBase {
      */
     data?: string | string[]
   }
-  body: {
+  body?: {
     /**
      * A query string used to match name-related fields in user profile documents.
      * Name-related fields are the user's `username`, `full_name`, and `email`.
diff --git a/specification/security/update_api_key/Request.ts b/specification/security/update_api_key/Request.ts
@@ -63,7 +63,7 @@ export interface Request extends RequestBase {
      */
     id: Id
   }
-  body: {
+  body?: {
     /**
      * The role descriptors to assign to this API key.
      * The API key's effective permissions are an intersection of its assigned privileges and the point in time snapshot of permissions of the owner user.
diff --git a/specification/snapshot/create/SnapshotCreateRequest.ts b/specification/snapshot/create/SnapshotCreateRequest.ts
@@ -64,7 +64,7 @@ export interface Request extends RequestBase {
      */
     wait_for_completion?: boolean
   }
-  body: {
+  body?: {
     /**
      * Determines how wildcard patterns in the `indices` parameter match data streams and indices.
      * It supports comma-separated values such as `open,hidden`.
diff --git a/specification/snapshot/restore/SnapshotRestoreRequest.ts b/specification/snapshot/restore/SnapshotRestoreRequest.ts
@@ -83,7 +83,7 @@ export interface Request extends RequestBase {
      */
     wait_for_completion?: boolean
   }
-  body: {
+  body?: {
     /**
      * The feature states to restore.
      * If `include_global_state` is `true`, the request restores all feature states in the snapshot by default.
diff --git a/specification/transform/preview_transform/PreviewTransformRequest.ts b/specification/transform/preview_transform/PreviewTransformRequest.ts
@@ -70,7 +70,7 @@ export interface Request extends RequestBase {
      */
     timeout?: Duration
   }
-  body: {
+  body?: {
     /**
      * The destination for the transform.
      */
diff --git a/specification/watcher/execute_watch/WatcherExecuteWatchRequest.ts b/specification/watcher/execute_watch/WatcherExecuteWatchRequest.ts
@@ -69,7 +69,7 @@ export interface Request extends RequestBase {
      */
     debug?: boolean
   }
-  body: {
+  body?: {
     /**
      * Determines how to handle the watch actions as part of the watch execution.
      */
diff --git a/specification/watcher/query_watches/WatcherQueryWatchesRequest.ts b/specification/watcher/query_watches/WatcherQueryWatchesRequest.ts
@@ -39,7 +39,7 @@ export interface Request extends RequestBase {
       methods: ['GET', 'POST']
     }
   ]
-  body: {
+  body?: {
     /**
      * The offset from the first result to fetch.
      * It must be non-negative.

Original file line number	Diff line number	Diff line change
`@@ -121,7 +121,7 @@ export interface Request extends RequestBase {`
`121`	`121`	`*/`
`122`	`122`	`version_type?: VersionType`
`123`	`123`	`}`
`124`		`- body: {`
	`124`	`+ body?: {`
`125`	`125`	`/**`
`126`	`126`	`* An array of existing or artificial documents.`
`127`	`127`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -267,7 +267,7 @@ export interface Request extends RequestBase {`
`267`	`267`	`*/`
`268`	`268`	`with_labels?: boolean`
`269`	`269`	`}`
`270`		`- body: {`
	`270`	`+ body?: {`
`271`	`271`	`/**`
`272`	`272`	`* Sub-aggregations for the geotile_grid.`
`273`	`273`	`*`
Original file line number	Diff line number	Diff line change
`@@ -165,7 +165,7 @@ export interface Request<TDocument> extends RequestBase {`
`165`	`165`	`*/`
`166`	`166`	`version_type?: VersionType`
`167`	`167`	`}`
`168`		`- body: {`
	`168`	`+ body?: {`
`169`	`169`	`/**`
`170`	`170`	`* An artificial document (a document not present in the index) for which you want to retrieve term vectors.`
`171`	`171`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -158,7 +158,7 @@ export interface Request extends RequestBase {`
`158`	`158`	`from?: integer`
`159`	`159`	`sort?: string \| string[]`
`160`	`160`	`}`
`161`		`- body: {`
	`161`	`+ body?: {`
`162`	`162`	`/** @aliases aggs */`
`163`	`163`	`aggregations?: Dictionary<string, AggregationContainer>`
`164`	`164`	`collapse?: FieldCollapse`
Original file line number	Diff line number	Diff line change
`@@ -50,7 +50,7 @@ export interface Request extends RequestBase {`
`50`	`50`	`*/`
`51`	`51`	`master_timeout?: Duration`
`52`	`52`	`}`
`53`		`- body: {`
	`53`	`+ body?: {`
`54`	`54`	`max_outstanding_read_requests?: long`
`55`	`55`	`max_outstanding_write_requests?: long`
`56`	`56`	`max_read_request_operation_count?: long`
Original file line number	Diff line number	Diff line change
`@@ -54,7 +54,7 @@ export interface Request extends RequestBase {`
`54`	`54`	`*/`
`55`	`55`	`dry_run?: boolean`
`56`	`56`	`}`
`57`		`- body: {`
	`57`	`+ body?: {`
`58`	`58`	`legacy_template_to_delete?: string`
`59`	`59`	`node_attribute?: string`
`60`	`60`	`}`