Delete an anomaly detection job | Elasticsearch API documentation

Delete an anomaly detection job Generally available; Added in 5.4.0

DELETE /_ml/anomaly_detectors/{job_id}

All job configuration, model state and results are deleted. It is not currently possible to delete multiple jobs using wildcards or a comma separated list. If you delete a job that has a datafeed, the request first tries to delete the datafeed. This behavior is equivalent to calling the delete datafeed API with the same timeout and force parameters as the delete job request.

Required authorization

Cluster privileges: manage_ml

Path parameters

job_id string Required

Identifier for the anomaly detection job.

Query parameters

force boolean

Use to forcefully delete an opened job; this method is quicker than closing and deleting the job.
delete_user_annotations boolean

Specifies whether annotations that have been added by the user should be deleted along with any auto-generated annotations when the job is reset.
wait_for_completion boolean

Specifies whether the request should return immediately or wait until the job deletion completes.

Responses

200 application/json
Hide response attribute Show response attribute object
- acknowledged boolean Required
  
  For a successful response, this value is always true. On failure, an exception is returned instead.

DELETE /_ml/anomaly_detectors/{job_id}

DELETE _ml/anomaly_detectors/total-requests

resp = client.ml.delete_job(
    job_id="total-requests",
)

const response = await client.ml.deleteJob({
  job_id: "total-requests",
});

response = client.ml.delete_job(
  job_id: "total-requests"
)

$resp = $client->ml()->deleteJob([
    "job_id" => "total-requests",
]);

curl -X DELETE -H "Authorization: ApiKey $ELASTIC_API_KEY" "$ELASTICSEARCH_URL/_ml/anomaly_detectors/total-requests"

client.ml().deleteJob(d -> d
    .jobId("total-requests")
);

Response examples (200)

A successful response when deleting an anomaly detection job.

{
  "acknowledged": true
}

A successful response when deleting an anomaly detection job asynchronously. When the `wait_for_completion` query parameter is set to `false`, the response contains an identifier for the job deletion task.

{
  "task": "oTUltX4IQMOUUVeiohTt8A:39"
}