Add example subfolders

Author: lcawl

docs/overlays/elasticsearch-openapi-overlays.yaml

@@ -410,8 +410,8 @@ actions:
         content: 
           application/json: 
             examples:
-              esqlAsyncQueryRequestExample1: 
-                $ref: "../../specification/esql/async_query/EsqlAsyncQueryRequestExample1.yaml"
+              esqlAsyncQueryRequestExample1:
+                 $ref: "../../specification/esql/async_query/examples/request/AsyncQueryRequestExample1.yaml"
 ## Examples for licensing
   - target: "$.paths['/_license/basic_status']['get']"
     description: "Add example for get basic status response"

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -1172,7 +1172,7 @@ actions:
           application/json: 
             examples: 
               esqlQueryRequestExample1: 
-                $ref: "../../specification/esql/query/EsqlQueryApiRequestExample1.json"
+                $ref: "../../specification/esql/query/examples/request/QueryRequestExample1.yaml"
   - target: "$.components['requestBodies']['graph.explore']"
     description: "Add example for graph explore request"
     update: 

specification/esql/async_query/EsqlAsyncQueryRequestExample1.yaml renamed to specification/esql/async_query/examples/request/AsyncQueryRequestExample1.yaml

@@ -0,0 +1,14 @@
+# summary: 'Returns results for an ES|QL query.'
+# method_request: POST /_query
+# description: ''
+# type: request
+value: |-
+  {
+    "query": """
+      FROM library
+      | EVAL year = DATE_TRUNC(1 YEARS, release_date)
+      | STATS MAX(page_count) BY year
+      | SORT year
+      | LIMIT 5
+    """
+  }