diff --git a/elasticsearch-api/lib/elasticsearch/api/actions/esql/async_query.rb b/elasticsearch-api/lib/elasticsearch/api/actions/esql/async_query.rb
index 51e6f17abc..0224659435 100644
--- a/elasticsearch-api/lib/elasticsearch/api/actions/esql/async_query.rb
+++ b/elasticsearch-api/lib/elasticsearch/api/actions/esql/async_query.rb
@@ -27,6 +27,7 @@ module Actions
         # @option arguments [String] :format a short version of the Accept header, e.g. json, yaml
         # @option arguments [String] :delimiter The character to use between values within a CSV row. Only valid for the csv format.
         # @option arguments [Boolean] :drop_null_columns Should entirely null columns be removed from the results? Their name and type will be returning in a new `all_columns` section.
+        # @option arguments [Boolean] :allow_partial_results If `true`, partial results will be returned if there are shard failures, but the query can continue to execute on other clusters and shards. If `false`, the entire query will fail if there are any failures.
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body Use the `query` element to start a query. Use `columnar` to format the answer. (*Required*)
         #
diff --git a/elasticsearch-api/lib/elasticsearch/api/actions/esql/query.rb b/elasticsearch-api/lib/elasticsearch/api/actions/esql/query.rb
index dd91bdb3ed..333af20c3a 100644
--- a/elasticsearch-api/lib/elasticsearch/api/actions/esql/query.rb
+++ b/elasticsearch-api/lib/elasticsearch/api/actions/esql/query.rb
@@ -27,6 +27,7 @@ module Actions
         # @option arguments [String] :format a short version of the Accept header, e.g. json, yaml
         # @option arguments [String] :delimiter The character to use between values within a CSV row. Only valid for the csv format.
         # @option arguments [Boolean] :drop_null_columns Should entirely null columns be removed from the results? Their name and type will be returning in a new `all_columns` section.
+        # @option arguments [Boolean] :allow_partial_results If `true`, partial results will be returned if there are shard failures, but the query can continue to execute on other clusters and shards. If `false`, the entire query will fail if there are any failures.
         # @option arguments [Hash] :headers Custom HTTP headers
         # @option arguments [Hash] :body Use the `query` element to start a query. Use `columnar` to format the answer. (*Required*)
         #
diff --git a/elasticsearch-api/utils/thor/generator/docs_helper.rb b/elasticsearch-api/utils/thor/generator/docs_helper.rb
index fc41b885da..6e21174182 100644
--- a/elasticsearch-api/utils/thor/generator/docs_helper.rb
+++ b/elasticsearch-api/utils/thor/generator/docs_helper.rb
@@ -23,7 +23,7 @@ def docs(name, info)
         info['type'] = 'String' if info['type'] == 'enum' # Rename 'enums' to 'strings'
         info['type'] = 'Integer' if info['type'] == 'int' # Rename 'int' to 'Integer'
         tipo = info['type'] ? info['type'].capitalize : 'String'
-        description = info['description'] ? info['description'].strip : '[TODO]'
+        description = info['description'] ? info['description'].strip.gsub("\n", ' ') : '[TODO]'
         options = info['options'] ? "(options: #{info['options'].join(', ').strip})" : nil
         required = info['required'] ? '(*Required*)' : ''
         deprecated = info['deprecated'] ? '*Deprecated*' : ''