Delete an async ES|QL query Added in 8.13.0
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
Path parameters
-
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 totrue
.
DELETE
/_query/async/{id}
curl \
-X DELETE http://api.example.com/_query/async/{id}
Response examples (200)
{
"acknowledged": true
}