diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
index f2eba8418c..85be999795 100644
--- a/output/openapi/elasticsearch-openapi.json
+++ b/output/openapi/elasticsearch-openapi.json
@@ -10631,7 +10631,7 @@
           {
             "in": "query",
             "name": "format",
-            "description": "A short version of the Accept header, for example `json` or `yaml`.",
+            "description": "A short version of the Accept header, e.g. json, yaml.\n\n`csv`, `tsv`, and `txt` formats will return results in a tabular format, excluding other metadata fields from the response.\n\nFor async requests, nothing will be returned if the async query doesn't finish within the timeout.\nThe query ID and running status are available in the `X-Elasticsearch-Async-Id` and `X-Elasticsearch-Async-Is-Running` HTTP headers of the response, respectively.",
             "deprecated": false,
             "schema": {
               "$ref": "#/components/schemas/esql._types.EsqlFormat"
@@ -11048,7 +11048,7 @@
           {
             "in": "query",
             "name": "format",
-            "description": "A short version of the Accept header, e.g. json, yaml.",
+            "description": "A short version of the Accept header, e.g. json, yaml.\n\n`csv`, `tsv`, and `txt` formats will return results in a tabular format, excluding other metadata fields from the response.",
             "deprecated": false,
             "schema": {
               "$ref": "#/components/schemas/esql._types.EsqlFormat"
@@ -83464,9 +83464,11 @@
             "type": "object",
             "properties": {
               "id": {
+                "description": "The ID of the async query, to be used in subsequent requests to check the status or retrieve results.\n\nAlso available in the `X-Elasticsearch-Async-Id` HTTP header.",
                 "type": "string"
               },
               "is_running": {
+                "description": "Indicates whether the async query is still running or has completed.\n\nAlso available in the `X-Elasticsearch-Async-Is-Running` HTTP header.",
                 "type": "boolean"
               }
             },
diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
index 3f5396cb82..4fa3db84ab 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -6246,7 +6246,7 @@
           {
             "in": "query",
             "name": "format",
-            "description": "A short version of the Accept header, e.g. json, yaml.",
+            "description": "A short version of the Accept header, e.g. json, yaml.\n\n`csv`, `tsv`, and `txt` formats will return results in a tabular format, excluding other metadata fields from the response.",
             "deprecated": false,
             "schema": {
               "$ref": "#/components/schemas/esql._types.EsqlFormat"
diff --git a/output/schema/schema.json b/output/schema/schema.json
index 6ef363d3ac..a6c68f9428 100644
--- a/output/schema/schema.json
+++ b/output/schema/schema.json
@@ -137508,6 +137508,7 @@
       },
       "properties": [
         {
+          "description": "The ID of the async query, to be used in subsequent requests to check the status or retrieve results.\n\nAlso available in the `X-Elasticsearch-Async-Id` HTTP header.",
           "name": "id",
           "required": false,
           "type": {
@@ -137519,6 +137520,7 @@
           }
         },
         {
+          "description": "Indicates whether the async query is still running or has completed.\n\nAlso available in the `X-Elasticsearch-Async-Is-Running` HTTP header.",
           "name": "is_running",
           "required": true,
           "type": {
@@ -137530,7 +137532,7 @@
           }
         }
       ],
-      "specLocation": "esql/_types/EsqlResult.ts#L45-L48"
+      "specLocation": "esql/_types/EsqlResult.ts#L45-L58"
     },
     {
       "kind": "interface",
@@ -137607,7 +137609,7 @@
           }
         }
       ],
-      "specLocation": "esql/_types/EsqlResult.ts#L65-L71"
+      "specLocation": "esql/_types/EsqlResult.ts#L75-L81"
     },
     {
       "kind": "interface",
@@ -137705,7 +137707,7 @@
           }
         }
       ],
-      "specLocation": "esql/_types/EsqlResult.ts#L55-L63"
+      "specLocation": "esql/_types/EsqlResult.ts#L65-L73"
     },
     {
       "kind": "enum",
@@ -137730,7 +137732,7 @@
         "name": "EsqlClusterStatus",
         "namespace": "esql._types"
       },
-      "specLocation": "esql/_types/EsqlResult.ts#L73-L79"
+      "specLocation": "esql/_types/EsqlResult.ts#L83-L89"
     },
     {
       "kind": "interface",
@@ -137762,7 +137764,7 @@
           }
         }
       ],
-      "specLocation": "esql/_types/EsqlResult.ts#L50-L53"
+      "specLocation": "esql/_types/EsqlResult.ts#L60-L63"
     },
     {
       "kind": "enum",
@@ -137968,7 +137970,7 @@
           }
         }
       ],
-      "specLocation": "esql/_types/EsqlResult.ts#L88-L93"
+      "specLocation": "esql/_types/EsqlResult.ts#L98-L103"
     },
     {
       "kind": "interface",
@@ -138022,7 +138024,7 @@
           }
         }
       ],
-      "specLocation": "esql/_types/EsqlResult.ts#L81-L86"
+      "specLocation": "esql/_types/EsqlResult.ts#L91-L96"
     },
     {
       "kind": "interface",
@@ -138465,7 +138467,7 @@
           }
         },
         {
-          "description": "A short version of the Accept header, for example `json` or `yaml`.",
+          "description": "A short version of the Accept header, e.g. json, yaml.\n\n`csv`, `tsv`, and `txt` formats will return results in a tabular format, excluding other metadata fields from the response.\n\nFor async requests, nothing will be returned if the async query doesn't finish within the timeout.\nThe query ID and running status are available in the `X-Elasticsearch-Async-Id` and `X-Elasticsearch-Async-Is-Running` HTTP headers of the response, respectively.",
           "name": "format",
           "required": false,
           "type": {
@@ -138477,7 +138479,7 @@
           }
         }
       ],
-      "specLocation": "esql/async_query/AsyncQueryRequest.ts#L28-L133"
+      "specLocation": "esql/async_query/AsyncQueryRequest.ts#L28-L138"
     },
     {
       "kind": "response",
@@ -139240,7 +139242,7 @@
       "path": [],
       "query": [
         {
-          "description": "A short version of the Accept header, e.g. json, yaml.",
+          "description": "A short version of the Accept header, e.g. json, yaml.\n\n`csv`, `tsv`, and `txt` formats will return results in a tabular format, excluding other metadata fields from the response.",
           "name": "format",
           "required": false,
           "type": {
@@ -139290,7 +139292,7 @@
           }
         }
       ],
-      "specLocation": "esql/query/QueryRequest.ts#L27-L113"
+      "specLocation": "esql/query/QueryRequest.ts#L27-L115"
     },
     {
       "kind": "response",
diff --git a/specification/esql/_types/EsqlResult.ts b/specification/esql/_types/EsqlResult.ts
index 649e323d2b..b3d37ed3f9 100644
--- a/specification/esql/_types/EsqlResult.ts
+++ b/specification/esql/_types/EsqlResult.ts
@@ -43,7 +43,17 @@ export class EsqlResult {
 }
 
 export class AsyncEsqlResult extends EsqlResult {
+  /**
+   * The ID of the async query, to be used in subsequent requests to check the status or retrieve results.
+   *
+   * Also available in the `X-Elasticsearch-Async-Id` HTTP header.
+   */
   id?: string
+  /**
+   * Indicates whether the async query is still running or has completed.
+   *
+   * Also available in the `X-Elasticsearch-Async-Is-Running` HTTP header.
+   */
   is_running: boolean
 }
 
diff --git a/specification/esql/async_query/AsyncQueryRequest.ts b/specification/esql/async_query/AsyncQueryRequest.ts
index f14574f1c4..87709cef94 100644
--- a/specification/esql/async_query/AsyncQueryRequest.ts
+++ b/specification/esql/async_query/AsyncQueryRequest.ts
@@ -58,7 +58,12 @@ export interface Request extends RequestBase {
      */
     drop_null_columns?: boolean
     /**
-     * A short version of the Accept header, for example `json` or `yaml`.
+     * A short version of the Accept header, e.g. json, yaml.
+     *
+     * `csv`, `tsv`, and `txt` formats will return results in a tabular format, excluding other metadata fields from the response.
+     *
+     * For async requests, nothing will be returned if the async query doesn't finish within the timeout.
+     * The query ID and running status are available in the `X-Elasticsearch-Async-Id` and `X-Elasticsearch-Async-Is-Running` HTTP headers of the response, respectively.
      */
     format?: EsqlFormat
   }
diff --git a/specification/esql/query/QueryRequest.ts b/specification/esql/query/QueryRequest.ts
index 735974d5e1..91004d2312 100644
--- a/specification/esql/query/QueryRequest.ts
+++ b/specification/esql/query/QueryRequest.ts
@@ -43,6 +43,8 @@ export interface Request extends RequestBase {
   query_parameters: {
     /**
      * A short version of the Accept header, e.g. json, yaml.
+     *
+     * `csv`, `tsv`, and `txt` formats will return results in a tabular format, excluding other metadata fields from the response.
      */
     format?: EsqlFormat
     /**