diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index 22fd0d70d1..e6528ef25f 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -39969,6 +39969,16 @@
               "$ref": "#/components/schemas/_types.Id"
             },
             "style": "simple"
+          },
+          {
+            "in": "query",
+            "name": "refresh",
+            "description": "If `true`, the request will refresh the analyzers with the new synonyms set and wait for the new synonyms to be available before returning.\nIf `false`, analyzers will not be reloaded with the new synonym set",
+            "deprecated": false,
+            "schema": {
+              "type": "boolean"
+            },
+            "style": "form"
           }
         ],
         "requestBody": {
@@ -40016,8 +40026,7 @@
                     }
                   },
                   "required": [
-                    "result",
-                    "reload_analyzers_details"
+                    "result"
                   ]
                 }
               }
@@ -40142,6 +40151,16 @@
               "$ref": "#/components/schemas/_types.Id"
             },
             "style": "simple"
+          },
+          {
+            "in": "query",
+            "name": "refresh",
+            "description": "If `true`, the request will refresh the analyzers with the new synonym rule and wait for the new synonyms to be available before returning.\nIf `false`, analyzers will not be reloaded with the new synonym rule",
+            "deprecated": false,
+            "schema": {
+              "type": "boolean"
+            },
+            "style": "form"
           }
         ],
         "requestBody": {
@@ -40218,6 +40237,16 @@
               "$ref": "#/components/schemas/_types.Id"
             },
             "style": "simple"
+          },
+          {
+            "in": "query",
+            "name": "refresh",
+            "description": "If `true`, the request will refresh the analyzers with the deleted synonym rule and wait for the new synonyms to be available before returning.\nIf `false`, analyzers will not be reloaded with the deleted synonym rule",
+            "deprecated": false,
+            "schema": {
+              "type": "boolean"
+            },
+            "style": "form"
           }
         ],
         "responses": {
@@ -96066,8 +96095,7 @@
           }
         },
         "required": [
-          "result",
-          "reload_analyzers_details"
+          "result"
         ]
       },
       "synonyms._types.SynonymRuleRead": {
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
index 7e67bd81d9..1606a9f283 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -21196,8 +21196,7 @@
                     }
                   },
                   "required": [
-                    "result",
-                    "reload_analyzers_details"
+                    "result"
                   ]
                 }
               }
@@ -60199,8 +60198,7 @@
           }
         },
         "required": [
-          "result",
-          "reload_analyzers_details"
+          "result"
         ]
       },
       "indices.reload_search_analyzers.ReloadResult": {
diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json
index 6fa0a4b38d..e3adb1ede6 100644
--- a/output/schema/schema-serverless.json
+++ b/output/schema/schema-serverless.json
@@ -48068,7 +48068,7 @@
         }
       ],
       "query": [],
-      "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L48"
+      "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L57"
     },
     {
       "body": {
@@ -48436,13 +48436,14 @@
         }
       ],
       "query": [],
-      "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L55"
+      "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L64"
     },
     {
       "body": {
         "kind": "properties",
         "properties": [
           {
+            "description": "The update operation result.",
             "name": "result",
             "required": true,
             "type": {
@@ -48454,8 +48455,9 @@
             }
           },
           {
+            "description": "Updating a synonyms set can reload the associated analyzers in case refresh is set to true.\nThis information is the analyzers reloading result.",
             "name": "reload_analyzers_details",
-            "required": true,
+            "required": false,
             "type": {
               "kind": "instance_of",
               "type": {
@@ -48471,7 +48473,7 @@
         "name": "Response",
         "namespace": "synonyms.put_synonym"
       },
-      "specLocation": "synonyms/put_synonym/SynonymsPutResponse.ts#L23-L28"
+      "specLocation": "synonyms/put_synonym/SynonymsPutResponse.ts#L23-L36"
     },
     {
       "attachedBehaviors": [
@@ -48544,7 +48546,7 @@
         }
       ],
       "query": [],
-      "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L60"
+      "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L69"
     },
     {
       "body": {
@@ -148533,9 +148535,9 @@
           }
         },
         {
-          "description": "Updating synonyms in a synonym set reloads the associated analyzers.\nThis information is the analyzers reloading result.",
+          "description": "Updating synonyms in a synonym set can reload the associated analyzers in case refresh is set to true.\nThis information is the analyzers reloading result.",
           "name": "reload_analyzers_details",
-          "required": true,
+          "required": false,
           "type": {
             "kind": "instance_of",
             "type": {
diff --git a/output/schema/schema.json b/output/schema/schema.json
index 81a944ac88..5b31c2a7a3 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -227719,9 +227719,9 @@
           }
         },
         {
-          "description": "Updating synonyms in a synonym set reloads the associated analyzers.\nThis information is the analyzers reloading result.",
+          "description": "Updating synonyms in a synonym set can reload the associated analyzers in case refresh is set to true.\nThis information is the analyzers reloading result.",
           "name": "reload_analyzers_details",
-          "required": true,
+          "required": false,
           "type": {
             "kind": "instance_of",
             "type": {
@@ -227833,8 +227833,27 @@
           }
         }
       ],
-      "query": [],
-      "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L48"
+      "query": [
+        {
+          "availability": {
+            "stack": {
+              "since": "9.1.0"
+            }
+          },
+          "description": "If `true`, the request will refresh the analyzers with the deleted synonym rule and wait for the new synonyms to be available before returning.\nIf `false`, analyzers will not be reloaded with the deleted synonym rule",
+          "name": "refresh",
+          "required": false,
+          "serverDefault": true,
+          "type": {
+            "kind": "instance_of",
+            "type": {
+              "name": "boolean",
+              "namespace": "_builtins"
+            }
+          }
+        }
+      ],
+      "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L57"
     },
     {
       "kind": "response",
@@ -228235,8 +228254,27 @@
           }
         }
       ],
-      "query": [],
-      "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L55"
+      "query": [
+        {
+          "availability": {
+            "stack": {
+              "since": "9.1.0"
+            }
+          },
+          "description": "If `true`, the request will refresh the analyzers with the new synonyms set and wait for the new synonyms to be available before returning.\nIf `false`, analyzers will not be reloaded with the new synonym set",
+          "name": "refresh",
+          "required": false,
+          "serverDefault": true,
+          "type": {
+            "kind": "instance_of",
+            "type": {
+              "name": "boolean",
+              "namespace": "_builtins"
+            }
+          }
+        }
+      ],
+      "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L64"
     },
     {
       "kind": "response",
@@ -228244,6 +228282,7 @@
         "kind": "properties",
         "properties": [
           {
+            "description": "The update operation result.",
             "name": "result",
             "required": true,
             "type": {
@@ -228255,8 +228294,9 @@
             }
           },
           {
+            "description": "Updating a synonyms set can reload the associated analyzers in case refresh is set to true.\nThis information is the analyzers reloading result.",
             "name": "reload_analyzers_details",
-            "required": true,
+            "required": false,
             "type": {
               "kind": "instance_of",
               "type": {
@@ -228271,7 +228311,7 @@
         "name": "Response",
         "namespace": "synonyms.put_synonym"
       },
-      "specLocation": "synonyms/put_synonym/SynonymsPutResponse.ts#L23-L28"
+      "specLocation": "synonyms/put_synonym/SynonymsPutResponse.ts#L23-L36"
     },
     {
       "kind": "request",
@@ -228343,8 +228383,27 @@
           }
         }
       ],
-      "query": [],
-      "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L60"
+      "query": [
+        {
+          "availability": {
+            "stack": {
+              "since": "9.1.0"
+            }
+          },
+          "description": "If `true`, the request will refresh the analyzers with the new synonym rule and wait for the new synonyms to be available before returning.\nIf `false`, analyzers will not be reloaded with the new synonym rule",
+          "name": "refresh",
+          "required": false,
+          "serverDefault": true,
+          "type": {
+            "kind": "instance_of",
+            "type": {
+              "name": "boolean",
+              "namespace": "_builtins"
+            }
+          }
+        }
+      ],
+      "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L69"
     },
     {
       "kind": "response",
diff --git a/output/typescript/types.ts b/output/typescript/types.ts
index b891475aca..e07f71dae4 100644
--- a/output/typescript/types.ts
+++ b/output/typescript/types.ts
@@ -21033,7 +21033,7 @@ export type SynonymsSynonymString = string
 
 export interface SynonymsSynonymsUpdateResult {
   result: Result
-  reload_analyzers_details: IndicesReloadSearchAnalyzersReloadResult
+  reload_analyzers_details?: IndicesReloadSearchAnalyzersReloadResult
 }
 
 export interface SynonymsDeleteSynonymRequest extends RequestBase {
@@ -21045,6 +21045,7 @@ export type SynonymsDeleteSynonymResponse = AcknowledgedResponseBase
 export interface SynonymsDeleteSynonymRuleRequest extends RequestBase {
   set_id: Id
   rule_id: Id
+  refresh?: boolean
 }
 
 export type SynonymsDeleteSynonymRuleResponse = SynonymsSynonymsUpdateResult
@@ -21084,6 +21085,7 @@ export interface SynonymsGetSynonymsSetsSynonymsSetItem {
 
 export interface SynonymsPutSynonymRequest extends RequestBase {
   id: Id
+  refresh?: boolean
   body?: {
     synonyms_set: SynonymsSynonymRule | SynonymsSynonymRule[]
   }
@@ -21091,12 +21093,13 @@ export interface SynonymsPutSynonymRequest extends RequestBase {
 
 export interface SynonymsPutSynonymResponse {
   result: Result
-  reload_analyzers_details: IndicesReloadSearchAnalyzersReloadResult
+  reload_analyzers_details?: IndicesReloadSearchAnalyzersReloadResult
 }
 
 export interface SynonymsPutSynonymRuleRequest extends RequestBase {
   set_id: Id
   rule_id: Id
+  refresh?: boolean
   body?: {
     synonyms: SynonymsSynonymString
   }
diff --git a/specification/synonyms/_types/SynonymsUpdateResult.ts b/specification/synonyms/_types/SynonymsUpdateResult.ts
index 85ac5232fb..8b0e1245a2 100644
--- a/specification/synonyms/_types/SynonymsUpdateResult.ts
+++ b/specification/synonyms/_types/SynonymsUpdateResult.ts
@@ -27,8 +27,8 @@ export class SynonymsUpdateResult {
   result: Result
 
   /**
-   * Updating synonyms in a synonym set reloads the associated analyzers.
+   * Updating synonyms in a synonym set can reload the associated analyzers in case refresh is set to true.
    * This information is the analyzers reloading result.
    */
-  reload_analyzers_details: ReloadResult
+  reload_analyzers_details?: ReloadResult
 }
diff --git a/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts b/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts
index 03e686382d..6ae296a578 100644
--- a/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts
+++ b/specification/synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts
@@ -45,4 +45,13 @@ export interface Request extends RequestBase {
      */
     rule_id: Id
   }
+  query_parameters: {
+    /**
+     * If `true`, the request will refresh the analyzers with the deleted synonym rule and wait for the new synonyms to be available before returning.
+     * If `false`, analyzers will not be reloaded with the deleted synonym rule
+     * @server_default true
+     * @availability stack since=9.1.0
+     */
+    refresh?: boolean
+  }
 }
diff --git a/specification/synonyms/put_synonym/SynonymsPutRequest.ts b/specification/synonyms/put_synonym/SynonymsPutRequest.ts
index b6ed5ca6da..809c5d0a11 100644
--- a/specification/synonyms/put_synonym/SynonymsPutRequest.ts
+++ b/specification/synonyms/put_synonym/SynonymsPutRequest.ts
@@ -52,4 +52,13 @@ export interface Request extends RequestBase {
      */
     synonyms_set: SynonymRule | SynonymRule[]
   }
+  query_parameters: {
+    /**
+     * If `true`, the request will refresh the analyzers with the new synonyms set and wait for the new synonyms to be available before returning.
+     * If `false`, analyzers will not be reloaded with the new synonym set
+     * @server_default true
+     * @availability stack since=9.1.0
+     */
+    refresh?: boolean
+  }
 }
diff --git a/specification/synonyms/put_synonym/SynonymsPutResponse.ts b/specification/synonyms/put_synonym/SynonymsPutResponse.ts
index 26cce885f0..c181292e1a 100644
--- a/specification/synonyms/put_synonym/SynonymsPutResponse.ts
+++ b/specification/synonyms/put_synonym/SynonymsPutResponse.ts
@@ -22,7 +22,15 @@ import { Result } from '@_types/Result'
 
 export class Response {
   body: {
+    /**
+     * The update operation result.
+     */
     result: Result
-    reload_analyzers_details: ReloadResult
+
+    /**
+     * Updating a synonyms set can reload the associated analyzers in case refresh is set to true.
+     * This information is the analyzers reloading result.
+     */
+    reload_analyzers_details?: ReloadResult
   }
 }
diff --git a/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts b/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts
index 35a640d421..83e187d00d 100644
--- a/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts
+++ b/specification/synonyms/put_synonym_rule/SynonymRulePutRequest.ts
@@ -57,4 +57,13 @@ export interface Request extends RequestBase {
      */
     synonyms: SynonymString
   }
+  query_parameters: {
+    /**
+     * If `true`, the request will refresh the analyzers with the new synonym rule and wait for the new synonyms to be available before returning.
+     * If `false`, analyzers will not be reloaded with the new synonym rule
+     * @server_default true
+     * @availability stack since=9.1.0
+     */
+    refresh?: boolean
+  }
 }