Docs
Elasticsearch Guide [8.1] » REST APIs » SQL APIs » Delete async SQL search API
« Clear SQL cursor API Get async SQL search API »

Delete async SQL search API

Deletes an async SQL search or a stored synchronous SQL search. If the search is still running, the API cancels it.

DELETE _sql/async/delete/FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM=

Request

DELETE _sql/async/delete/<search_id>

Prerequisites

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

    • Users with the cancel_task cluster privilege
    • The user who first submitted the search

Limitations

See SQL Limitations.

Path parameters

<search_id>
(Required, string) Identifier for the search.
« Clear SQL cursor API Get async SQL search API »