9.1.0

Enhancements

• ES|QL query builder (technical preview) (#2997)
• Update OpenTelemetry conventions (#2999)
• Add option to disable accurate reporting of file and line location in warnings (Fixes #3003) (#3006)

APIs

• Remove if_primary_term, if_seq_no and op_type from Create API
• Remove master_timeout from Ingest Get Ip Location Database API
• Remove application, priviledge and username from the Security Get User API
• Rename type_query_string to type in License Post Start Trial API
• Add require_data_stream to Index API
• Add settings_filter to Cluster Get Component Template API
• Add cause to Cluster Put Component Template API
• Add master_timeout to Cluster State API
• Add ccs_minimize_roundtrips to EQL Search API
• Add keep_alive and keep_on_completion to ES|QL Async Query API
• Add format to ES|QL Async Query Get API
• Add ES|QL Get Query and List Queries APIs
• Add Indices Delete Data Stream Options API
• Add Indices Get Data Stream Options and Put Data Stream Options APIS
• Add Indices Get Data Stream Settings and Put Data Stream Settings APIs
• Add allow_no_indices, expand_wildcards and ignore_available to Indices Recovery API
• Add Indices Remove Block API
• Add Amazon Sagemaker to Inference API
• Add input_type to Inference API
• Add timeout to all Inference Put APIs
• Add Inference Put Custom API
• Add Inference Put DeepSeek API
• Add task_settings to Put HuggingFace API
• Add refresh to Security Grant API Key API
• Add wait_for_completion to the Snapshot Delete API
• Add state to Snapshot Get API
• Add refresh to Synonyms Put Synonym, Put Synonym Rule and Delete Synonym Rule APIs

DSL

• Handle lists in copy_to option in DSL field declarations correctly (Fixes #2992) (#2993)
• Add index_options to SparseVector type
• Add SparseVectorIndexOptions type
• Add key to FiltersBucket type

Other changes

• Drop support for Python 3.8 (#3001)

9.0.3

Enhancements

• ES|QL query builder (technical preview) (#2997)
• Add option to disable accurate reporting of file and line location in warnings (Fixes #3003) (#3006)

APIs

• Remove if_primary_term, if_seq_no and op_type from Create API
• Remove stored_fields from Get Source API
• Remove master_timeout from Ingest Get Ip Location Database API
• Remove application, priviledge and username from the Security Get User API
• Rename type_query_string to type in License Post Start Trial API
• Add require_data_stream to Index API
• Add settings_filter to Cluster Get Component Template API
• Add cause to Cluster Put Component Template API
• Add ccs_minimize_roundtrips to EQL Search API
• Add keep_alive and keep_on_completion to ES|QL Async Query API
• Add format to ES|QL Async Query Get API
• Add allow_no_indices, expand_wildcards and ignore_available to Indices Recovery API
• Add timeout to all Inference Put APIs
• Add refresh to Security Get User Profile API
• Add wait_for_completion to the Snapshot Delete API

DSL

• Handle lists in copy_to field option correctly (Fixes #2992) (#2993)
• Add key to FiltersBucket type

8.19.0

Enhancements

• ES|QL query builder (technical preview) (#2997)
• Add option to disable accurate reporting of file and line location in warnings (Fixes #3003) (#3006)

API updates

• Remove if_primary_term, if_seq_no and op_type from Create API
• Remove stored_fields from Get Source API
• Remove min_compatible_shard_node from Async Search Submit API
• Remove master_timeout from Cat Aliases API
• Remove master_timeout from Ingest Get Ip Location Database API
• Remove application, priviledge and username from the Security Get User API
• Rename type_query_string to type in License Post Start Trial API
• Add require_data_stream to Index API
• Add settings_filter to Cluster Get Component Template API
• Add cause to Cluster Put Component Template API
• Add ccs_minimize_roundtrips to EQL Search API
• Add keep_alive and keep_on_completion to ES|QL Async Query API
• Add format to ES|QL Async Query Get API
• Add allow_no_indices, expand_wildcards and ignore_available to Indices Recovery API
• Add input_type to Inference API
• Add timeout to all Inference Put APIs
• Add Inference Put Custom API
• Add refresh to Security Get User Profile API
• Add wait_for_completion to the Snapshot Delete API

DSL Updates

• Handle lists in copy_to option in DSL field declarations correctly (Fixes #2992) (#2994)
• Add key to FiltersBucket type

9.0.2

DSL

• Add rescore_vector to DenseVectorIndexOptions

8.18.1

• Update APIs
  • Add back inference.inference APIs that were removed by mistake
• Update DSL
  • Add CountedKeyword and Passthrough fields
  • Add rescore_vector to Knn query
  • Add bbq_flat and bbq_hnsw vector index types
  • Add script and on_script_error to Date and DateNanos fields

9.0.1

• Surface caused_by in ApiError (#2932)
• Clarify Elasticsearch 9.x compatibility (#2928)
• Reorganize Sphinx docs to only include reference pages (#2776)

9.0.0

Important

Upgrade to Elasticsearch 9 before using elasticsearch-py 9.0.0 or later. Using elasticsearch-py 9.0.0 on an Elasticsearch 8 server will fail.
Since language clients are forward-compatible, you should first upgrade Elasticsearch, then the Elasticsearch client. See the compatibility documentation for more details.

• Remove deprecated Elasticsearch() options (#2840)
• Remove deprecated url_prefix and use_ssl options (#2797)
• Merge Elasticsearch-DSL package (#2736)
• Add Python DSL documentation (#2761)
• Autogenerate DSL field classes from schema (#2780)
• Improve DSL documentation examples with class-based queries and type hints (#2857)
• Document the use of param() in Python DSL methods (#2861)
• Migrate documentation from AsciiDoc to Markdown format (#2806)
• Document use of sub-clients (#2798)
• Document how to making API calls (#2843)
• Fix simulate sub-client documentation (#2749)
• Update APIs
  • Remove Unfreeze an index API
  • Remove min_compatible_shard_node from Search and Async Search Submit APIs
  • Remove local parameter from cat alias, Alias exists, and Get alias APIs
  • Remove verbose from Index segments API
  • Remove include_model_definition from Get trained model configuration info API
  • Remove wait_for_active_shards from experimental Get field usage stats API
  • Support soft-deletes in connectors:
    • Add hard to Delete connector API
    • Add include_deleted to Get and List Connector APIs
  • Add master_timeout to Migrate to data tiers routing APIs
  • Add master_timeout to the Alias exists and Get alias APIs.
  • Add expand_wildcards to Create snapshot API
  • Rename incorrect access_token to token in Logout of OpenID Connect API
  • Add inference APIs: Alibaba Cloud AI Search, Amazon Bedrock, Anthropic, Azure AI Studio, Azure OpenAI, Cohere, Elasticsearch, ELSER, Google AI Studio, Google Vertex AI, Hugging Face, Jina AI, Mistral, OpenAI, and Voyage AI
  • Add Reindex legacy backing indices APIs
  • Add Create an index from a source index API
  • Add include_source_on_error to Create, Index, Update and Bulk APIs
  • Add Stop async ES|QL query API
  • Add timeout to Resolve Cluster API
  • Add adaptive_allocations body field to Start and Update a trained model deployment API
  • Rename index_template_subtitutions to index_template_substitutions in Simulate data ingestion API* Add if_primary_term, if_seq_no, op_type, require_alias and require_data_stream to Create API
  • Add max_concurrent_shard_requests to Open point in time API
  • Add local and flat_settings to Check index templates API
  • Add reopen to Update index settings API
  • Add resource to Reload search analyzer API
  • Add lazy to Roll over to a new index API
  • Add cause and create to Simulate index template APIs
  • Add Elastic Inference Service (EIS) chat completion
  • Add inference APIs: Alibaba Cloud AI Search, Amazon Bedrock, Anthropic, Azure AI Studio, Azure OpenAI, Cohere, Elastic Inference Service (EIS), Elasticsearch, ELSER, Google AI Studio, Google Vertex AI, Hugging Face, Jina AI, Mistral, OpenAI, and Voyage AI
• Update DSL
  • Add ignore_malformed, script, on_script_error and time_series_dimension to Boolean field
  • Add index to GeoShape field
  • Add search_inference_id to SemanticText field

8.18.0

• Merge Elasticsearch-DSL <https://github.com/elastic/elasticsearch-dsl-py/>_ package (#2736)
• Add Python DSL documentation (#2761)
• Autogenerate DSL field classes from schema (#2780)
• Improve DSL documentation examples with class-based queries and type hints (#2857)
• Document the use of param() in Python DSL methods (#2861)
• Document use of sub-clients (#2798)
• Fix simulate sub-client documentation (#2749)
• Update APIs
  • Remove wait_for_active_shards from experimental Get field usage stats API
  • Rename incorrect access_token to token in Logout of OpenID Connect API
  • Add inference APIs: Alibaba Cloud AI Search, Amazon Bedrock, Anthropic, Azure AI Studio, Azure OpenAI, Cohere, Elasticsearch, ELSER, Google AI Studio, Google Vertex AI, Hugging Face, Jina AI, Mistral, OpenAI, and Voyage AI
  • Add Reindex legacy backing indices APIs
  • Add Create an index from a source index API
  • Add include_source_on_error to Create, Index, Update and Bulk APIs
  • Add Stop async ES|QL query API
  • Add timeout to Resolve Cluster API
  • Add adaptive_allocations body field to Start and Update a trained model deployment API
  • Rename index_template_subtitutions to index_template_substitutions in Simulate data ingestion API* Add if_primary_term, if_seq_no, op_type, require_alias and require_data_stream to Create API
  • Add max_concurrent_shard_requests to Open point in time API
  • Add local and flat_settings to Check index templates API
  • Add reopen to Update index settings API
  • Add resource to Reload search analyzer API
  • Add lazy to Roll over to a new index API
  • Add cause and create to Simulate index template APIs
  • Add Elastic Inference Service (EIS) chat completion
  • Add inference APIs: Alibaba Cloud AI Search, Amazon Bedrock, Anthropic, Azure AI Studio, Azure OpenAI, Cohere, Elastic Inference Service (EIS), Elasticsearch, ELSER, Google AI Studio, Google Vertex AI, Hugging Face, Jina AI, Mistral, OpenAI, and Voyage AI
• Update DSL
  • Add ignore_malformed, script, on_script_error and time_series_dimension to Boolean field
  • Add index to GeoShape field
  • Add search_inference_id to SemanticText field

8.17.2

8.17.2 (2025-03-04)

• Explain how to use sub clients in API docs (#2798)
• Render descriptions as Markdown in API docs
• Update APIs
  • Add keep_alive to Submit async search API
  • Add Run and Delete async ES|QL query APIs
  • Add Get async ES|QL query results API
  • Add include_ccs_metadata to ES|QL query API

8.17.1

8.17.1 (2025-01-23)

• Make pyarrow dependency optional for tests (#2733, contributed by @danigm)
• Update APIs:
  • Add Simulate ingest API
  • Add Get data stream lifecycle stats API
  • Add Update inference API
  • Add Create or update, Get and Delete IP geolocation database configuration APIs
  • Add Bulk update API keys
  • Add Get and Update Security index settings APIs
  • Add OpenID Connect prepare authentication, OpenID Connect authenticate and OpenID Connect logout APIs
  • Add Delegate PKI authentication API
  • Add Repository analysis API
  • Add Render Search Application Query API
  • Add Find field structure and Find messages structure APIs
  • Add Get Watcher index settings and Update Watcher index settings APIs
  • Add experimental Check in and Claim connector sync job APIs
  • Add experimental Set connector sync job errors and Set connector sync job stats APIs
  • Add experimental Update connector features APIs
  • Add experimental Post Event to an Analytics Collection API
  • Add timeout and master_timeout to Snapshot lifecycle management (SLM) APIs
  • Add allow_partial_search_results to SQL search API
  • Add throttle_period_in_millis to Create or update watch API
  • Fix query parameters for CAT APIs