Delete trained model API

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

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

Request

DELETE _ml/inference/<model_id>

Prerequisites

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 parameters

<model_id>

(Optional, string) The unique identifier of the trained model.

Response codes

409

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

Examples

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

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

The API returns the following result:

{
  "acknowledged" : true
}