Delete an async ES|QL query
- DELETE /_query/async/{id}
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_taskcluster privilege
Path Parameters
-
idstring Idrequired -
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_completionparameter set totrue.
Response
application/json
-
acknowledgedbooleanrequired -
For a successful response, this value is always true. On failure, an exception is returned instead.