IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Delete trained model aliases API Get trained models API »
Elastic Docs ›Elasticsearch Guide [7.16] ›REST APIs ›Machine learning trained model APIs

Delete trained models API

edit

Delete trained models API

edit

Deletes an existing trained inference model that is currently not referenced by an ingest pipeline.

Request

edit

DELETE _ml/trained_models/<model_id>

Prerequisites

edit

Requires the manage_ml cluster privilege. This privilege is included in the machine_learning_admin built-in role.

Path parameters

edit
<model_id>
(Optional, string) The unique identifier of the trained model.

Response codes

edit
409
The code indicates that the trained model is referenced by an ingest pipeline and cannot be deleted.

Examples

edit

The following example deletes the regression-job-one-1574775307356 trained model:

DELETE _ml/trained_models/regression-job-one-1574775307356

The API returns the following result:

{
  "acknowledged" : true
}
« Delete trained model aliases API Get trained models API »