elastic · ivancea · Jul 29, 2025 · Jul 29, 2025 · Jul 29, 2025 · Jul 29, 2025
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/specification/esql/async_query/AsyncQueryRequest.ts b/specification/esql/async_query/AsyncQueryRequest.ts
@@ -58,7 +58,11 @@ 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.
      */
     format?: EsqlFormat
   }

diff --git 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
     /**