Delete an async ES|QL query

  • DELETE /_query/async/{id}
Auth

If the query is still running, it is cancelled. Otherwise, the stored results are deleted.

If the Elasticsearch security features are enabled, only the following users can use this API to delete a query:

  • The authenticated user that submitted the original query request
  • Users with the cancel_task cluster privilege
More about ES|QL reference

Path parameters

id string required

The unique identifier of the query. A query ID is provided in the ES|QL async query API response for a query that does not complete in the designated time. A query ID is also provided when the request was submitted with the keep_on_completion parameter set to true.

Response

application/json
acknowledged boolean required

For a successful response, this value is always true. On failure, an exception is returned instead.