---
type: api
title: Machine learning trained model
description: The machine learning trained models APIs enable you to perform model management operations.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/group/endpoint-ml-trained-model
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/group/endpoint-ml-trained-model
products:
  - Elasticsearch
---

# Machine learning trained model

`ml trained model`

The machine learning trained models APIs enable you to perform model management operations.

[Learn more about natural language processing.](https://www.elastic.co/docs/explore-analyze/machine-learning/nlp/ml-nlp-overview)

- [Clear trained model deployment cache](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-clear-trained-model-deployment-cache): `POST` `/_ml/trained_models/{model_id}/deployment/cache/_clear`
- [Get trained model configuration info
](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-get-trained-models): `GET` `/_ml/trained_models/{model_id}`, `GET` `/_ml/trained_models`
- [Create a trained model](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-put-trained-model): `PUT` `/_ml/trained_models/{model_id}`
- [Delete an unreferenced trained model](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-delete-trained-model): `DELETE` `/_ml/trained_models/{model_id}`
- [Create or update a trained model alias](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-put-trained-model-alias): `PUT` `/_ml/trained_models/{model_id}/model_aliases/{model_alias}`
- [Delete a trained model alias](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-delete-trained-model-alias): `DELETE` `/_ml/trained_models/{model_id}/model_aliases/{model_alias}`
- [Get trained models usage info
](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-get-trained-models-stats): `GET` `/_ml/trained_models/{model_id}/_stats`, `GET` `/_ml/trained_models/_stats`
- [Evaluate a trained model](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-infer-trained-model): `POST` `/_ml/trained_models/{model_id}/_infer`
- [Create part of a trained model definition](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-put-trained-model-definition-part): `PUT` `/_ml/trained_models/{model_id}/definition/{part}`
- [Create a trained model vocabulary](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-put-trained-model-vocabulary): `PUT` `/_ml/trained_models/{model_id}/vocabulary`
- [Start a trained model deployment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-start-trained-model-deployment): `POST` `/_ml/trained_models/{model_id}/deployment/_start`
- [Stop a trained model deployment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-stop-trained-model-deployment): `POST` `/_ml/trained_models/{model_id}/deployment/_stop`
- [Update a trained model deployment](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/operation/operation-ml-update-trained-model-deployment): `POST` `/_ml/trained_models/{model_id}/deployment/_update`