IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Delete data frame analytics jobs API Evaluate data frame analytics API »
Elastic Docs ›Elasticsearch Guide [7.8] ›REST APIs ›Machine learning data frame analytics APIs

Delete inference trained model API

edit

Delete inference trained model API

edit

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

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

Request

edit

DELETE _ml/inference/<model_id>

Prerequisites

edit

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

  • machine_learning_admin
  • kibana_admin (UI only)

For more information, see Security privileges and Built-in roles.

Path parameters

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

Response codes

edit
409
The code indicates that the trained inference 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/inference/regression-job-one-1574775307356

The API returns the following result:

{
  "acknowledged" : true
}
« Delete data frame analytics jobs API Evaluate data frame analytics API »