Delete data frame analytics jobs APIedit

Deletes an existing data frame analytics job.

This functionality is in technical preview and may be changed or removed in a future release. Elastic will apply best effort to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.


DELETE _ml/data_frame/analytics/<data_frame_analytics_id>


If the Elasticsearch security features are enabled, you must have the following built-in roles or equivalent privileges:

  • machine_learning_admin

For more information, see Built-in roles and Machine learning security privileges.

Path parametersedit

(Required, string) Identifier for the data frame analytics job.

Query parametersedit

(Optional, Boolean) If true, it deletes a job that is not stopped; this method is quicker than stopping and deleting the job.
(Optional, time units) The time to wait for the job to be deleted. Defaults to 1 minute.


The following example deletes the loganalytics data frame analytics job:

DELETE _ml/data_frame/analytics/loganalytics

The API returns the following result:

  "acknowledged" : true