Prep 8.15.2 for release (#2443)

Co-authored-by: Josh Mock <joshua.mock@elastic.co>

.gitignore

@@ -64,3 +64,6 @@ test/bundlers/parcel-test/.parcel-cache
 
 lib
 junit-output
+bun.lockb
+test-results
+processinfo

docs/changelog.asciidoc

@@ -1,6 +1,28 @@
 [[changelog-client]]
 == Release notes
 
+[discrete]
+=== 8.15.2
+
+[discrete]
+==== Features
+
+[discrete]
+===== Improved support for Elasticsearch `v8.15`
+
+Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
+
+[discrete]
+=== 8.15.1
+
+[discrete]
+==== Features
+
+[discrete]
+===== Improved support for Elasticsearch `v8.15`
+
+Updated TypeScript types based on fixes and improvements to the Elasticsearch specification.
+
 [discrete]
 === 8.15.0
 

docs/configuration.asciidoc

@@ -2,10 +2,11 @@
 == Configuration
 
 
-The client is designed to be easily configured for your needs. In the following 
+The client is designed to be easily configured for your needs. In the following
 section, you can see the possible options that you can use to configure it.
 
 * <<basic-config>>
 * <<advanced-config>>
+* <<timeout-best-practices>>
 * <<child>>
 * <<client-testing>>

docs/doc_examples/01ae196538fac197eedbbf458a4ef31b.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       kwd: {
         type: "keyword",

docs/doc_examples/0709a38613d2de90d418ce12b36af30e.asciidoc

@@ -0,0 +1,8 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.cluster.reroute();
+console.log(response);
+----

docs/doc_examples/0bee07a581c5776e068f6f4efad5a399.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.esql.asyncQuery({
+  format: "json",
+  body: {
+    query:
+      "\n    FROM my-index-000001,cluster_one:my-index-000001,cluster_two:my-index*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",
+    include_ccs_metadata: true,
+  },
+});
+console.log(response);
+----

docs/doc_examples/0c8be7aec84ea86b243904f5d4162f5a.asciidoc

@@ -4,14 +4,12 @@
 [source, js]
 ----
 const response = await client.search({
-  index: "my-index",
+  index: "cooking_blog",
   query: {
-    semantic: {
-      field: "inference_field",
-      query: "mountain lake",
-      inner_hits: {
-        from: 1,
-        size: 1,
+    match: {
+      title: {
+        query: "fluffy pancakes breakfast",
+        minimum_should_match: 2,
       },
     },
   },

docs/doc_examples/0d30077cd34e93377a3a86f2ebd69415.asciidoc

@@ -9,7 +9,7 @@ const response = await client.connector.put({
   name: "My Connector",
   description: "My Connector to sync data to Elastic index from Google Drive",
   service_type: "google_drive",
-  language: "english",
+  language: "en",
 });
 console.log(response);
 ----

docs/doc_examples/0e31b8ad176b31028becf9500989bcbd.asciidoc

@@ -0,0 +1,21 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.put({
+  task_type: "text_embedding",
+  inference_id: "watsonx-embeddings",
+  inference_config: {
+    service: "watsonxai",
+    service_settings: {
+      api_key: "<api_key>",
+      url: "<url>",
+      model_id: "ibm/slate-30m-english-rtrvr",
+      project_id: "<project_id>",
+      api_version: "2024-03-14",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/11be807bdeaeecc8174dec88e0851ea7.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.transport.request({
+  method: "GET",
+  path: "/_connector/_sync_job",
+  querystring: {
+    connector_id: "my-connector-id",
+    size: "1",
+  },
+});
+console.log(response);
+----

docs/doc_examples/12e9e758f7f18a6cbf27e9d0aea57a19.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.update({
+  index: ".elastic-connectors",
+  id: "connector_id",
+  doc: {
+    features: {
+      native_connector_api_keys: {
+        enabled: true,
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/1522a9297151d7046e6345b9b27539ca.asciidoc

@@ -0,0 +1,19 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.connector.updateConfiguration({
+  connector_id: "my-connector-id",
+  values: {
+    host: "127.0.0.1",
+    port: 5432,
+    username: "myuser",
+    password: "mypassword",
+    database: "chinook",
+    schema: "public",
+    tables: "album,artist",
+  },
+});
+console.log(response);
+----

docs/doc_examples/15f769bbd7b5fddeb3353ae726b71b14.asciidoc

@@ -0,0 +1,28 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "my-index-bit-vectors",
+  query: {
+    script_score: {
+      query: {
+        match_all: {},
+      },
+      script: {
+        source: "dotProduct(params.query_vector, 'my_dense_vector')",
+        params: {
+          query_vector: [
+            0.23, 1.45, 3.67, 4.89, -0.56, 2.34, 3.21, 1.78, -2.45, 0.98, -0.12,
+            3.45, 4.56, 2.78, 1.23, 0.67, 3.89, 4.12, -2.34, 1.56, 0.78, 3.21,
+            4.12, 2.45, -1.67, 0.34, -3.45, 4.56, -2.78, 1.23, -0.67, 3.89,
+            -4.34, 2.12, -1.56, 0.78, -3.21, 4.45, 2.12, 1.67,
+          ],
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/16a7ce08b4a6b3af269f27eecc71d664.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.delete({
+  index: "books",
+});
+console.log(response);
+
+const response1 = await client.indices.delete({
+  index: "my-explicit-mappings-books",
+});
+console.log(response1);
+----

docs/doc_examples/17316a81c9dbdd120b7754116bf0461c.asciidoc

@@ -0,0 +1,26 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.security.createApiKey({
+  name: "my-connector-api-key",
+  role_descriptors: {
+    "my-connector-connector-role": {
+      cluster: ["monitor", "manage_connector"],
+      indices: [
+        {
+          names: [
+            "my-index_name",
+            ".search-acl-filter-my-index_name",
+            ".elastic-connectors*",
+          ],
+          privileges: ["all"],
+          allow_restricted_indices: false,
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/191074b2eebd5f74e628c2ada4b6d2e4.asciidoc

@@ -0,0 +1,55 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    bool: {
+      must: [
+        {
+          term: {
+            "category.keyword": "Main Course",
+          },
+        },
+        {
+          term: {
+            tags: "vegetarian",
+          },
+        },
+        {
+          range: {
+            rating: {
+              gte: 4.5,
+            },
+          },
+        },
+      ],
+      should: [
+        {
+          multi_match: {
+            query: "curry spicy",
+            fields: ["title^2", "description"],
+          },
+        },
+        {
+          range: {
+            date: {
+              gte: "now-1M/d",
+            },
+          },
+        },
+      ],
+      must_not: [
+        {
+          term: {
+            "category.keyword": "Dessert",
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/193704020a19714dec390452a4e75e8d.asciidoc

@@ -4,12 +4,7 @@
 [source, js]
 ----
 const response = await client.indices.create({
-  index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
-    },
-  },
+  index: "books",
 });
 console.log(response);
 ----

docs/doc_examples/1a7483796087053ba55029d0dc2ab356.asciidoc

@@ -4,14 +4,16 @@
 [source, js]
 ----
 const response = await client.index({
-  index: "my-index",
-  id: "lake_tahoe",
+  index: "mv",
+  refresh: "true",
   document: {
-    inference_field: [
-      "Lake Tahoe is the largest alpine lake in North America",
-      "When hiking in the area, please be on alert for bears",
-    ],
+    a: [2, null, 1],
   },
 });
 console.log(response);
+
+const response1 = await client.esql.query({
+  query: "FROM mv | LIMIT 1",
+});
+console.log(response1);
 ----

docs/doc_examples/1aa96eeaf63fc967e166d1a2fcdccccc.asciidoc

@@ -4,7 +4,7 @@
 [source, js]
 ----
 const response = await client.indices.create({
-  index: "my-index-000003",
+  index: "my-index-000002",
   mappings: {
     properties: {
       metrics: {
@@ -29,7 +29,7 @@ const response = await client.indices.create({
 console.log(response);
 
 const response1 = await client.indices.getMapping({
-  index: "my-index-000003",
+  index: "my-index-000002",
 });
 console.log(response1);
 ----

docs/doc_examples/1c9dac4183a3532c91dbd1a46907729b.asciidoc

@@ -3,8 +3,8 @@
 
 [source, js]
 ----
-const response = await client.cluster.reroute({
-  metric: "none",
+const response = await client.indices.delete({
+  index: "music",
 });
 console.log(response);
 ----

docs/doc_examples/1fb2c77c0988bc6545040b20e3afa7e9.asciidoc

@@ -0,0 +1,33 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.security.createApiKey({
+  name: "john-api-key",
+  expiration: "1d",
+  role_descriptors: {
+    "sharepoint-online-role": {
+      index: [
+        {
+          names: ["sharepoint-search-application"],
+          privileges: ["read"],
+          query: {
+            template: {
+              params: {
+                access_control: ["john@example.co", "Engineering Members"],
+              },
+              source:
+                '\n              {\n                "bool": {\n                  "should": [\n                    {\n                      "bool": {\n                        "must_not": {\n                          "exists": {\n                            "field": "_allow_access_control"\n                          }\n                        }\n                      }\n                    },\n                    {\n                      "terms": {\n                        "_allow_access_control.enum": {{#toJson}}access_control{{/toJson}}\n                      }\n                    }\n                  ]\n                }\n              }\n              ',
+            },
+          },
+        },
+      ],
+      restriction: {
+        workflows: ["search_application_query"],
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/21d41e8cbd107fbdf0901f885834dafc.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       card: {
         type: "wildcard",

docs/doc_examples/2c079d1ae4819a0c206b9e1aa5623523.asciidoc

@@ -0,0 +1,77 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "my-index-000001",
+  mappings: {
+    properties: {
+      attributes: {
+        type: "passthrough",
+        priority: 10,
+        properties: {
+          id: {
+            type: "keyword",
+          },
+        },
+      },
+    },
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "my-index-000001",
+  id: 1,
+  document: {
+    attributes: {
+      id: "foo",
+      zone: 10,
+    },
+  },
+});
+console.log(response1);
+
+const response2 = await client.search({
+  index: "my-index-000001",
+  query: {
+    bool: {
+      must: [
+        {
+          match: {
+            id: "foo",
+          },
+        },
+        {
+          match: {
+            zone: 10,
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response2);
+
+const response3 = await client.search({
+  index: "my-index-000001",
+  query: {
+    bool: {
+      must: [
+        {
+          match: {
+            "attributes.id": "foo",
+          },
+        },
+        {
+          match: {
+            "attributes.zone": 10,
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response3);
+----

docs/doc_examples/2c86840a46242a38cf82024a9321be46.asciidoc

@@ -0,0 +1,28 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "my-explicit-mappings-books",
+  mappings: {
+    dynamic: false,
+    properties: {
+      name: {
+        type: "text",
+      },
+      author: {
+        type: "text",
+      },
+      release_date: {
+        type: "date",
+        format: "yyyy-MM-dd",
+      },
+      page_count: {
+        type: "integer",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/2d0244c020075595acb625aa5ba8f455.asciidoc

@@ -0,0 +1,25 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.index({
+  index: "idx_keep",
+  id: 1,
+  document: {
+    path: {
+      to: [
+        {
+          foo: [3, 2, 1],
+        },
+        {
+          foo: [30, 20, 10],
+        },
+      ],
+      bar: "baz",
+    },
+    ids: [200, 100, 300, 100],
+  },
+});
+console.log(response);
+----

docs/doc_examples/2e7844477b41fcfa9efefee4ec0e7101.asciidoc

@@ -0,0 +1,43 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "my-index-000001",
+  retriever: {
+    rule: {
+      match_criteria: {
+        query_string: "puggles",
+        user_country: "us",
+      },
+      ruleset_ids: ["my-ruleset"],
+      retriever: {
+        rrf: {
+          retrievers: [
+            {
+              standard: {
+                query: {
+                  query_string: {
+                    query: "pugs",
+                  },
+                },
+              },
+            },
+            {
+              standard: {
+                query: {
+                  query_string: {
+                    query: "puggles",
+                  },
+                },
+              },
+            },
+          ],
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/339c4e5af9f9069ad9912aa574488b59.asciidoc

@@ -0,0 +1,52 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "my-index-bit-vectors",
+  mappings: {
+    properties: {
+      my_dense_vector: {
+        type: "dense_vector",
+        index: false,
+        element_type: "bit",
+        dims: 40,
+      },
+    },
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "my-index-bit-vectors",
+  id: 1,
+  document: {
+    my_dense_vector: [8, 5, -15, 1, -7],
+  },
+});
+console.log(response1);
+
+const response2 = await client.index({
+  index: "my-index-bit-vectors",
+  id: 2,
+  document: {
+    my_dense_vector: [-1, 115, -3, 4, -128],
+  },
+});
+console.log(response2);
+
+const response3 = await client.index({
+  index: "my-index-bit-vectors",
+  id: 3,
+  document: {
+    my_dense_vector: [2, 18, -5, 0, -124],
+  },
+});
+console.log(response3);
+
+const response4 = await client.indices.refresh({
+  index: "my-index-bit-vectors",
+});
+console.log(response4);
+----

docs/doc_examples/3ab8f65fcb55a0e3664c55749ec41efd.asciidoc

@@ -29,6 +29,7 @@ const response = await client.indices.create({
             "arabic_normalization",
             "persian_normalization",
             "persian_stop",
+            "persian_stem",
           ],
         },
       },

docs/doc_examples/40f287bf733420bbab134b74c7d0ea5d.asciidoc

@@ -0,0 +1,16 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.index({
+  index: "amazon-reviews",
+  id: 1,
+  document: {
+    review_text:
+      "This product is lifechanging! I'm telling all my friends about it.",
+    review_vector: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8],
+  },
+});
+console.log(response);
+----

docs/doc_examples/44198781d164a15be633d4469485a544.asciidoc

@@ -0,0 +1,23 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "my-index-bit-vectors",
+  query: {
+    script_score: {
+      query: {
+        match_all: {},
+      },
+      script: {
+        source: "dotProduct(params.query_vector, 'my_dense_vector')",
+        params: {
+          query_vector: [8, 5, -15, 1, -7],
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/49a19615ebe2c013b8321152163478ab.asciidoc

@@ -0,0 +1,42 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.index({
+  index: "my-index-000001",
+  id: 1,
+  refresh: "true",
+  document: {
+    text: "quick brown fox",
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "my-index-000001",
+  id: 2,
+  refresh: "true",
+  document: {
+    text: "quick fox",
+  },
+});
+console.log(response1);
+
+const response2 = await client.search({
+  index: "my-index-000001",
+  query: {
+    script_score: {
+      query: {
+        match: {
+          text: "quick brown fox",
+        },
+      },
+      script: {
+        source: "_termStats.termFreq().getAverage()",
+      },
+    },
+  },
+});
+console.log(response2);
+----

docs/doc_examples/4b91ad7c9b44e07db4a4e81390f19ad3.asciidoc

@@ -0,0 +1,14 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.streamInference({
+  task_type: "completion",
+  inference_id: "openai-completion",
+  body: {
+    input: "What is Elastic?",
+  },
+});
+console.log(response);
+----

docs/doc_examples/4da0cb8693e9ceceee2ba3b558014bbf.asciidoc

@@ -0,0 +1,38 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.updateByQuery({
+  index: "INDEX_NAME",
+  conflicts: "proceed",
+  query: {
+    bool: {
+      filter: [
+        {
+          match: {
+            object_type: "drive_item",
+          },
+        },
+        {
+          exists: {
+            field: "file",
+          },
+        },
+        {
+          range: {
+            lastModifiedDateTime: {
+              lte: "now-180d",
+            },
+          },
+        },
+      ],
+    },
+  },
+  script: {
+    source: "ctx._source.body = ''",
+    lang: "painless",
+  },
+});
+console.log(response);
+----

docs/doc_examples/529671ffaf7cc75fe83a81d729788be4.asciidoc

@@ -0,0 +1,31 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.update({
+  index: ".elastic-connectors",
+  id: "connector_id",
+  doc: {
+    configuration: {
+      field_a: {
+        type: "str",
+        value: "",
+      },
+      field_b: {
+        type: "bool",
+        value: false,
+      },
+      field_c: {
+        type: "int",
+        value: 1,
+      },
+      field_d: {
+        type: "list",
+        value: "a,b",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/54a47b5d07e7bfbea75c77f35eaae18d.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.putMapping({
+  index: ".elastic-connectors-sync-jobs-v1",
+  properties: {
+    job_type: {
+      type: "keyword",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/55085e6a2891040b6ac696561d0787c8.asciidoc

@@ -0,0 +1,32 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "my-index-000002",
+  mappings: {
+    properties: {
+      attributes: {
+        type: "passthrough",
+        priority: 10,
+        properties: {
+          id: {
+            type: "keyword",
+          },
+        },
+      },
+      "resource.attributes": {
+        type: "passthrough",
+        priority: 20,
+        properties: {
+          id: {
+            type: "keyword",
+          },
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/551799fef2f86e393db83a967e4a30d1.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       agg_metric: {
         type: "aggregate_metric_double",

docs/doc_examples/56da252798b8e7b006738428aa1a7f4c.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       my_range: {
         type: "long_range",

docs/doc_examples/58dd26afc919722e21358c91e112b27a.asciidoc

@@ -4,12 +4,13 @@
 [source, js]
 ----
 const response = await client.search({
-  index: "my-index",
+  index: "cooking_blog",
   query: {
-    semantic: {
-      field: "inference_field",
-      query: "mountain lake",
-      inner_hits: {},
+    range: {
+      date: {
+        gte: "2023-05-01",
+        lte: "2023-05-31",
+      },
     },
   },
 });

docs/doc_examples/5a70db31f587b7ffed5e9bc1445430cb.asciidoc

@@ -0,0 +1,22 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "semantic-embeddings",
+  mappings: {
+    properties: {
+      semantic_text: {
+        type: "semantic_text",
+        inference_id: "my-elser-endpoint",
+      },
+      content: {
+        type: "text",
+        copy_to: "semantic_text",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/5bba213a7f543190139d1a69ab2ed076.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.esql.asyncQuery({
+  format: "json",
+  body: {
+    query:
+      "\n    FROM cluster_one:my-index*,cluster_two:logs*\n    | STATS COUNT(http.response.status_code) BY user.id\n    | LIMIT 2\n  ",
+    include_ccs_metadata: true,
+  },
+});
+console.log(response);
+----

docs/doc_examples/5ceb734e3affe00e2cdc29af748d95bf.asciidoc

@@ -0,0 +1,23 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.put({
+  task_type: "sparse_embedding",
+  inference_id: "small_chunk_size",
+  inference_config: {
+    service: "elasticsearch",
+    service_settings: {
+      num_allocations: 1,
+      num_threads: 1,
+    },
+    chunking_settings: {
+      strategy: "sentence",
+      max_chunk_size: 100,
+      sentence_overlap: 0,
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/5cf12cc4f98d98dc79bead7e6556679c.asciidoc

@@ -4,12 +4,13 @@
 [source, js]
 ----
 const response = await client.indices.create({
-  index: "my-index-000002",
-  mappings: {
-    properties: {
-      datetime: {
-        type: "date",
-        format: "uuuu/MM/dd HH:mm:ss||uuuu/MM/dd||epoch_millis",
+  index: "idx",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
       },
     },
   },

docs/doc_examples/5daf8ede198be9b118da5bee9896cb00.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       flattened: {
         type: "flattened",

docs/doc_examples/6329fb2840a4373ff6d342f2653247cb.asciidoc

@@ -0,0 +1,10 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.getMapping({
+  index: "books",
+});
+console.log(response);
+----

docs/doc_examples/63a53fcb0717ae9033a679cbfc932851.asciidoc

@@ -0,0 +1,20 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.put({
+  task_type: "completion",
+  inference_id: "alibabacloud_ai_search_completion",
+  inference_config: {
+    service: "alibabacloud-ai-search",
+    service_settings: {
+      host: "default-j01.platform-cn-shanghai.opensearch.aliyuncs.com",
+      api_key: "{{API_KEY}}",
+      service_id: "ops-qwen-turbo",
+      workspace: "default",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/640dbeecb736bd25f6f2b392b76a7531.asciidoc

@@ -0,0 +1,10 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.cluster.stats({
+  include_remotes: "true",
+});
+console.log(response);
+----

docs/doc_examples/6cb1dae368c945ecf7c9ec332a5743a2.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       text: {
         type: "text",

docs/doc_examples/6f8bdca97e43aac75e32de655aa4314a.asciidoc

@@ -0,0 +1,10 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.connector.delete({
+  connector_id: "my-connector-id&delete_sync_jobs=true",
+});
+console.log(response);
+----

docs/doc_examples/7163346755400594d1dd7e445aa19ff0.asciidoc

@@ -0,0 +1,10 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "music",
+});
+console.log(response);
+----

docs/doc_examples/71998bb300ac2a58419b0772cdc1c586.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       versions: {
         type: "version",

docs/doc_examples/750ac969f9a05567f5cdf4f93d6244b6.asciidoc

@@ -4,7 +4,6 @@
 [source, js]
 ----
 const response = await client.cluster.reroute({
-  metric: "none",
   commands: [
     {
       allocate_empty_primary: {

docs/doc_examples/76c73b54f3f1e5cb1c0fcccd7c3fd18e.asciidoc

@@ -0,0 +1,52 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.bulk({
+  operations: [
+    {
+      index: {
+        _index: "amazon-reviews",
+        _id: "2",
+      },
+    },
+    {
+      review_text: "This product is amazing! I love it.",
+      review_vector: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8],
+    },
+    {
+      index: {
+        _index: "amazon-reviews",
+        _id: "3",
+      },
+    },
+    {
+      review_text: "This product is terrible. I hate it.",
+      review_vector: [0.8, 0.7, 0.6, 0.5, 0.4, 0.3, 0.2, 0.1],
+    },
+    {
+      index: {
+        _index: "amazon-reviews",
+        _id: "4",
+      },
+    },
+    {
+      review_text: "This product is great. I can do anything with it.",
+      review_vector: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8],
+    },
+    {
+      index: {
+        _index: "amazon-reviews",
+        _id: "5",
+      },
+    },
+    {
+      review_text:
+        "This product has ruined my life and the lives of my family and friends.",
+      review_vector: [0.8, 0.7, 0.6, 0.5, 0.4, 0.3, 0.2, 0.1],
+    },
+  ],
+});
+console.log(response);
+----

docs/doc_examples/77082b1ffaae9ac52dfc133fa597baa7.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    match: {
+      description: {
+        query: "fluffy pancakes",
+        operator: "and",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/79ff4e7fa5c004226d05d7e2bfb5dc1e.asciidoc

@@ -0,0 +1,49 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.putIndexTemplate({
+  name: "my-metrics",
+  index_patterns: ["metrics-mymetrics-*"],
+  priority: 200,
+  data_stream: {},
+  template: {
+    settings: {
+      "index.mode": "time_series",
+    },
+    mappings: {
+      properties: {
+        attributes: {
+          type: "passthrough",
+          priority: 10,
+          time_series_dimension: true,
+          properties: {
+            "host.name": {
+              type: "keyword",
+            },
+          },
+        },
+        cpu: {
+          type: "integer",
+          time_series_metric: "counter",
+        },
+      },
+    },
+  },
+});
+console.log(response);
+
+const response1 = await client.index({
+  index: "metrics-mymetrics-test",
+  document: {
+    "@timestamp": "2020-01-01T00:00:00.000Z",
+    attributes: {
+      "host.name": "foo",
+      zone: "bar",
+    },
+    cpu: 10,
+  },
+});
+console.log(response1);
+----

docs/doc_examples/7a27336a61284d079f3cc3994cf927d1.asciidoc

@@ -0,0 +1,50 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.security.createApiKey({
+  name: "my-api-key",
+  role_descriptors: {
+    "role-source1": {
+      indices: [
+        {
+          names: ["source1"],
+          privileges: ["read"],
+          query: {
+            template: {
+              params: {
+                access_control: [
+                  "example.user@example.com",
+                  "source1-user-group",
+                ],
+              },
+            },
+            source: "...",
+          },
+        },
+      ],
+    },
+    "role-source2": {
+      indices: [
+        {
+          names: ["source2"],
+          privileges: ["read"],
+          query: {
+            template: {
+              params: {
+                access_control: [
+                  "example.user@example.com",
+                  "source2-user-group",
+                ],
+              },
+            },
+            source: "...",
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/7a32f44a1511ecb0d3f0b0ff2aca5c44.asciidoc

@@ -1,23 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.updateAliases({
-  actions: [
-    {
-      remove: {
-        index: "my-index-000001",
-        alias: "my-index",
-      },
-    },
-    {
-      add: {
-        index: "my-index-000002",
-        alias: "my-index",
-      },
-    },
-  ],
-});
-console.log(response);
-----

docs/doc_examples/7af1f62b0cf496cbf593d83d30b472cc.asciidoc

@@ -0,0 +1,22 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.security.createApiKey({
+  name: "music-connector",
+  role_descriptors: {
+    "music-connector-role": {
+      cluster: ["monitor", "manage_connector"],
+      indices: [
+        {
+          names: ["music", ".search-acl-filter-music", ".elastic-connectors*"],
+          privileges: ["all"],
+          allow_restricted_indices: false,
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/7b1b947bddd7e78f77da265f7e645a61.asciidoc

@@ -1,51 +0,0 @@
-// This file is autogenerated, DO NOT EDIT
-// Use `node scripts/generate-docs-examples.js` to generate the docs examples
-
-[source, js]
-----
-const response = await client.indices.create({
-  index: "my-index-000004",
-  mappings: {
-    properties: {
-      metrics: {
-        subobjects: "auto",
-        properties: {
-          time: {
-            type: "object",
-            properties: {
-              min: {
-                type: "long",
-              },
-            },
-          },
-          to: {
-            type: "object",
-            properties: {
-              inner_metrics: {
-                type: "object",
-                subobjects: "auto",
-                properties: {
-                  time: {
-                    type: "object",
-                    properties: {
-                      max: {
-                        type: "long",
-                      },
-                    },
-                  },
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-  },
-});
-console.log(response);
-
-const response1 = await client.indices.getMapping({
-  index: "my-index-000004",
-});
-console.log(response1);
-----

docs/doc_examples/7b9691bd34a02dd859562eb927f175e0.asciidoc

@@ -0,0 +1,23 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.put({
+  task_type: "sparse_embedding",
+  inference_id: "my-elser-model",
+  inference_config: {
+    service: "elasticsearch",
+    service_settings: {
+      adaptive_allocations: {
+        enabled: true,
+        min_number_of_allocations: 1,
+        max_number_of_allocations: 10,
+      },
+      num_threads: 1,
+      model_id: ".elser_model_2",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/7d3a74fe0ba3fe95d1c3275365ff9315.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       flattened: {
         type: "flattened",

docs/doc_examples/7db09cab02d71f3a10d91071216d80fc.asciidoc

@@ -0,0 +1,18 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "amazon-reviews",
+  retriever: {
+    knn: {
+      field: "review_vector",
+      query_vector: [0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8],
+      k: 2,
+      num_candidates: 5,
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/7db798942cf2d334456e30ef5fcb801b.asciidoc

@@ -0,0 +1,17 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    match: {
+      description: {
+        query: "fluffy pancakes",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/8080cd9e24a8785728ce7c372ec4acf1.asciidoc

@@ -3,9 +3,10 @@
 
 [source, js]
 ----
-const response = await client.indices.putSettings({
-  index: ".watches",
-  settings: {
+const response = await client.transport.request({
+  method: "PUT",
+  path: "/_watcher/settings",
+  body: {
     "index.routing.allocation.include.role": "watcher",
   },
 });

docs/doc_examples/828f0045747fde4888a947bb99e190e3.asciidoc

@@ -0,0 +1,27 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "movies",
+  retriever: {
+    rule: {
+      match_criteria: {
+        query_string: "harry potter",
+      },
+      ruleset_ids: ["my-ruleset"],
+      retriever: {
+        standard: {
+          query: {
+            query_string: {
+              query: "harry potter",
+            },
+          },
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/84237aa9da49ab4b4c4e2b21d2548df2.asciidoc

@@ -3,9 +3,8 @@
 
 [source, js]
 ----
-const response = await client.snapshot.create({
-  repository: "my_repository",
-  snapshot: "_verify_integrity",
+const response = await client.snapshot.repositoryVerifyIntegrity({
+  name: "my_repository",
 });
 console.log(response);
 ----

docs/doc_examples/84ef9fe951c6d3caa7438238a5b23319.asciidoc

@@ -0,0 +1,15 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    term: {
+      "author.keyword": "Maria Rodriguez",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/853fc710cea79fb4e1a85fb6d149f9c5.asciidoc

@@ -0,0 +1,42 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "movies",
+  retriever: {
+    rule: {
+      match_criteria: {
+        query_string: "harry potter",
+      },
+      ruleset_ids: ["my-ruleset"],
+      retriever: {
+        rrf: {
+          retrievers: [
+            {
+              standard: {
+                query: {
+                  query_string: {
+                    query: "sorcerer's stone",
+                  },
+                },
+              },
+            },
+            {
+              standard: {
+                query: {
+                  query_string: {
+                    query: "chamber of secrets",
+                  },
+                },
+              },
+            },
+          ],
+        },
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/85f9fc6f98e8573efed9b034e853d5ae.asciidoc

@@ -0,0 +1,17 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.inference.put({
+  task_type: "sparse_embedding",
+  inference_id: "use_existing_deployment",
+  inference_config: {
+    service: "elasticsearch",
+    service_settings: {
+      deployment_id: ".elser_model_2",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/8b8b6aac2111b2d8b93758ac737e6543.asciidoc

@@ -0,0 +1,31 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "idx_keep",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
+    },
+  },
+  mappings: {
+    properties: {
+      path: {
+        type: "object",
+        synthetic_source_keep: "all",
+      },
+      ids: {
+        type: "integer",
+        synthetic_source_keep: "arrays",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/8d05862be1f9e7edaba162b1888b5677.asciidoc

@@ -0,0 +1,61 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.putMapping({
+  index: "cooking_blog",
+  properties: {
+    title: {
+      type: "text",
+      analyzer: "standard",
+      fields: {
+        keyword: {
+          type: "keyword",
+          ignore_above: 256,
+        },
+      },
+    },
+    description: {
+      type: "text",
+      fields: {
+        keyword: {
+          type: "keyword",
+        },
+      },
+    },
+    author: {
+      type: "text",
+      fields: {
+        keyword: {
+          type: "keyword",
+        },
+      },
+    },
+    date: {
+      type: "date",
+      format: "yyyy-MM-dd",
+    },
+    category: {
+      type: "text",
+      fields: {
+        keyword: {
+          type: "keyword",
+        },
+      },
+    },
+    tags: {
+      type: "text",
+      fields: {
+        keyword: {
+          type: "keyword",
+        },
+      },
+    },
+    rating: {
+      type: "float",
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/998c8479c8704bca0e121d5969859517.asciidoc

@@ -0,0 +1,10 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.count({
+  index: "music",
+});
+console.log(response);
+----

docs/doc_examples/9ad0864bcd665b63551e944653d32423.asciidoc

@@ -0,0 +1,35 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "semantic-embeddings",
+  retriever: {
+    rrf: {
+      retrievers: [
+        {
+          standard: {
+            query: {
+              match: {
+                content: "How to avoid muscle soreness while running?",
+              },
+            },
+          },
+        },
+        {
+          standard: {
+            query: {
+              semantic: {
+                field: "semantic_text",
+                query: "How to avoid muscle soreness while running?",
+              },
+            },
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/9aedc45f83e022732789e8d796f5a43c.asciidoc

@@ -4,7 +4,6 @@
 [source, js]
 ----
 const response = await client.cluster.reroute({
-  metric: "none",
   commands: [
     {
       move: {

docs/doc_examples/9bd5a470ee6d2b4a1f5280adc39675d2.asciidoc

@@ -0,0 +1,35 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.update({
+  index: ".elastic-connectors",
+  id: "connector_id",
+  doc: {
+    configuration: {
+      tables: {
+        type: "list",
+        value: "*",
+      },
+      ssl_enabled: {
+        type: "bool",
+        value: false,
+      },
+      ssl_ca: {
+        type: "str",
+        value: "",
+      },
+      fetch_size: {
+        type: "int",
+        value: 50,
+      },
+      retry_count: {
+        type: "int",
+        value: 3,
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/9c2ce0132e4527077443f007d27b1158.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       flattened: {
         type: "flattened",

docs/doc_examples/a1b668795243398f5bc40bcc9bead884.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       my_range: {
         type: "long_range",

docs/doc_examples/a5aeb2c8bdf91f6146026ec8edc476b6.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       date: {
         type: "date_nanos",

docs/doc_examples/a7d814caf2a995d2aeadecc3495011be.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       bool: {
         type: "boolean",

docs/doc_examples/a8dff54362184b2732b9bd248cf6df8a.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       my_range: {
         type: "integer_range",

docs/doc_examples/aab810de3314d5e11bd564ea096785b8.asciidoc

@@ -0,0 +1,21 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    bool: {
+      filter: [
+        {
+          term: {
+            "category.keyword": "Breakfast",
+          },
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/aad7d80990a6a3c391ff555ce09ae9dc.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       f: {
         type: "scaled_float",

docs/doc_examples/ac5b91aa75696f9880451c9439fd9eec.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       my_range: {
         type: "date_range",

docs/doc_examples/acc44366a9908684b2c8c2b119a4fb2b.asciidoc

@@ -5,11 +5,15 @@
 ----
 const response = await client.search({
   index: "my-index-000001",
-  query: {
+  retriever: {
     rule: {
-      organic: {
-        query_string: {
-          query: "puggles",
+      retriever: {
+        standard: {
+          query: {
+            query_string: {
+              query: "puggles",
+            },
+          },
         },
       },
       match_criteria: {

docs/doc_examples/add82cbe7cd95c4be5ce1c9958f2f208.asciidoc

@@ -0,0 +1,16 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    multi_match: {
+      query: "vegetarian curry",
+      fields: ["title^3", "description^2", "tags"],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/b3479ee4586c15020549afae58d94d65.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       point: {
         type: "geo_point",

docs/doc_examples/b3cd07f02059165fd62a2f148be3dc58.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       long: {
         type: "long",

docs/doc_examples/b3f442a7d9eb391121dcab991787f9d6.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       binary: {
         type: "binary",

docs/doc_examples/b8400dbe39215705060500f0e569f452.asciidoc

@@ -0,0 +1,10 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.connector.get({
+  connector_id: "my-connector-id",
+});
+console.log(response);
+----

docs/doc_examples/b9ba66209b7fcc111a7bcef0b3e00052.asciidoc

@@ -3,10 +3,14 @@
 
 [source, js]
 ----
-const response = await client.indices.putSettings({
+const response = await client.index({
   index: "my-index-000001",
-  settings: {
-    "index.merge.policy.max_merge_at_once_explicit": null,
+  id: 1,
+  document: {
+    attributes: {
+      id: "foo",
+    },
+    id: "bar",
   },
 });
 console.log(response);

docs/doc_examples/ba650046f9063f6c43d76f47e0f94403.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       date: {
         type: "date",

docs/doc_examples/bb5a67e3d2d9cd3016e487e627769fe8.asciidoc

@@ -0,0 +1,88 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.bulk({
+  index: "cooking_blog",
+  refresh: "wait_for",
+  operations: [
+    {
+      index: {
+        _id: "1",
+      },
+    },
+    {
+      title: "Perfect Pancakes: A Fluffy Breakfast Delight",
+      description:
+        "Learn the secrets to making the fluffiest pancakes, so amazing you won't believe your tastebuds. This recipe uses buttermilk and a special folding technique to create light, airy pancakes that are perfect for lazy Sunday mornings.",
+      author: "Maria Rodriguez",
+      date: "2023-05-01",
+      category: "Breakfast",
+      tags: ["pancakes", "breakfast", "easy recipes"],
+      rating: 4.8,
+    },
+    {
+      index: {
+        _id: "2",
+      },
+    },
+    {
+      title: "Spicy Thai Green Curry: A Vegetarian Adventure",
+      description:
+        "Dive into the flavors of Thailand with this vibrant green curry. Packed with vegetables and aromatic herbs, this dish is both healthy and satisfying. Don't worry about the heat - you can easily adjust the spice level to your liking.",
+      author: "Liam Chen",
+      date: "2023-05-05",
+      category: "Main Course",
+      tags: ["thai", "vegetarian", "curry", "spicy"],
+      rating: 4.6,
+    },
+    {
+      index: {
+        _id: "3",
+      },
+    },
+    {
+      title: "Classic Beef Stroganoff: A Creamy Comfort Food",
+      description:
+        "Indulge in this rich and creamy beef stroganoff. Tender strips of beef in a savory mushroom sauce, served over a bed of egg noodles. It's the ultimate comfort food for chilly evenings.",
+      author: "Emma Watson",
+      date: "2023-05-10",
+      category: "Main Course",
+      tags: ["beef", "pasta", "comfort food"],
+      rating: 4.7,
+    },
+    {
+      index: {
+        _id: "4",
+      },
+    },
+    {
+      title: "Vegan Chocolate Avocado Mousse",
+      description:
+        "Discover the magic of avocado in this rich, vegan chocolate mousse. Creamy, indulgent, and secretly healthy, it's the perfect guilt-free dessert for chocolate lovers.",
+      author: "Alex Green",
+      date: "2023-05-15",
+      category: "Dessert",
+      tags: ["vegan", "chocolate", "avocado", "healthy dessert"],
+      rating: 4.5,
+    },
+    {
+      index: {
+        _id: "5",
+      },
+    },
+    {
+      title: "Crispy Oven-Fried Chicken",
+      description:
+        "Get that perfect crunch without the deep fryer! This oven-fried chicken recipe delivers crispy, juicy results every time. A healthier take on the classic comfort food.",
+      author: "Maria Rodriguez",
+      date: "2023-05-20",
+      category: "Main Course",
+      tags: ["chicken", "oven-fried", "healthy"],
+      rating: 4.9,
+    },
+  ],
+});
+console.log(response);
+----

docs/doc_examples/bc01aee2ab2ce1690986374bd836e1c7.asciidoc

@@ -0,0 +1,16 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "cooking_blog",
+  query: {
+    multi_match: {
+      query: "vegetarian curry",
+      fields: ["title", "description", "tags"],
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/bdaf00d791706d7fde25fd65d3735b94.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       kwd: {
         type: "keyword",

docs/doc_examples/befa73a8a419fcf3b7798548b54a20bf.asciidoc

@@ -0,0 +1,37 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.search({
+  index: "my-index",
+  size: 10,
+  knn: {
+    query_vector: [0.04283529, 0.85670587, -0.51402352, 0],
+    field: "my_int4_vector",
+    k: 20,
+    num_candidates: 50,
+  },
+  rescore: {
+    window_size: 20,
+    query: {
+      rescore_query: {
+        script_score: {
+          query: {
+            match_all: {},
+          },
+          script: {
+            source: "(dotProduct(params.queryVector, 'my_int4_vector') + 1.0)",
+            params: {
+              queryVector: [0.04283529, 0.85670587, -0.51402352, 0],
+            },
+          },
+        },
+      },
+      query_weight: 0,
+      rescore_query_weight: 1,
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/c793efe7280e9b6e09981c4d4f832348.asciidoc

@@ -5,10 +5,16 @@
 ----
 const response = await client.indices.create({
   index: "idx",
-  mappings: {
-    _source: {
-      mode: "synthetic",
+  settings: {
+    index: {
+      mapping: {
+        source: {
+          mode: "synthetic",
+        },
+      },
     },
+  },
+  mappings: {
     properties: {
       ip: {
         type: "ip",

docs/doc_examples/c8aa8e8c0ac160b8c4efd1ac3b9f48f3.asciidoc

@@ -0,0 +1,23 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.indices.create({
+  index: "amazon-reviews",
+  mappings: {
+    properties: {
+      review_vector: {
+        type: "dense_vector",
+        dims: 8,
+        index: true,
+        similarity: "cosine",
+      },
+      review_text: {
+        type: "text",
+      },
+    },
+  },
+});
+console.log(response);
+----

docs/doc_examples/ccc613951c61f0b17e1ed8a2d3ae54a2.asciidoc

@@ -52,6 +52,20 @@ const response = await client.simulate.ingest({
         },
       },
     },
+    index_template_substitutions: {
+      "my-index-template": {
+        index_patterns: ["my-index-*"],
+        composed_of: ["component_template_1", "component_template_2"],
+      },
+    },
+    mapping_addition: {
+      dynamic: "strict",
+      properties: {
+        foo: {
+          type: "keyword",
+        },
+      },
+    },
   },
 });
 console.log(response);

docs/doc_examples/d1ea13e1e8372cbf1480a414723ff55a.asciidoc

@@ -0,0 +1,26 @@
+// This file is autogenerated, DO NOT EDIT
+// Use `node scripts/generate-docs-examples.js` to generate the docs examples
+
+[source, js]
+----
+const response = await client.security.createApiKey({
+  name: "connector_name-connector-api-key",
+  role_descriptors: {
+    "connector_name-connector-role": {
+      cluster: ["monitor", "manage_connector"],
+      indices: [
+        {
+          names: [
+            "index_name",
+            ".search-acl-filter-index_name",
+            ".elastic-connectors*",
+          ],
+          privileges: ["all"],
+          allow_restricted_indices: false,
+        },
+      ],
+    },
+  },
+});
+console.log(response);
+----