Delete anomaly detection jobs API

Deletes an existing anomaly detection job.

Request

DELETE _ml/anomaly_detectors/<job_id>

Prerequisites

• If Elasticsearch security features are enabled, you must have manage_ml or manage cluster privileges to use this API. See Security privileges and Machine learning security privileges.
• Before you can delete a job, you must delete the datafeeds that are associated with it. See Delete datafeeds.
• Before you can delete a job, you must close it (unless you specify the force parameter). See Close jobs.

Description

All job configuration, model state and results are deleted.

Deleting an anomaly detection job must be done via this API only. Do not delete the job directly from the .ml-* indices using the Elasticsearch delete document API. When Elasticsearch security features are enabled, make sure no write privileges are granted to anyone over the .ml-* indices.

It is not currently possible to delete multiple jobs using wildcards or a comma separated list.

Path parameters

<job_id>

(Required, string) Identifier for the anomaly detection job.

Query parameters

force

(Optional, boolean) Use to forcefully delete an opened job; this method is quicker than closing and deleting the job.

wait_for_completion

(Optional, boolean) Specifies whether the request should return immediately or wait until the job deletion completes. Defaults to true.

Examples

DELETE _ml/anomaly_detectors/total-requests

When the job is deleted, you receive the following results:

{
  "acknowledged": true
}

In the next example we delete the total-requests job asynchronously:

DELETE _ml/anomaly_detectors/total-requests?wait_for_completion=false

When wait_for_completion is set to false, the response contains the id of the job deletion task:

{
  "task": "oTUltX4IQMOUUVeiohTt8A:39"
}