# Delete an unreferenced trained model

**DELETE /_ml/trained_models/{model_id}**

The request deletes a trained inference model that is not referenced by an ingest pipeline.

## Required authorization

* Cluster privileges: `manage_ml`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **model_id** (string)
  The unique identifier of the trained model.

### Query parameters
- **force** (boolean)
  Forcefully deletes a trained model that is referenced by ingest pipelines or has a started deployment.
- **timeout** (string)
  Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.


## Responses
### 200


#### Body: application/json (object)
- **acknowledged** (boolean)
  For a successful response, this value is always true. On failure, an exception is returned instead.


[Powered by Bump.sh](https://bump.sh)