# Deleting a Model

## Model Version Deletion

A Merlin model version can be deleted only if it is not serving any endpoints and does not have any deployed endpoints or, if the base model is of the `pyfunc_v2` type, the model version must not have any active prediction jobs. Deleting a model version will result in the purging of the model version and its related entities, such as endpoints or prediction jobs, from the Merlin database. This action is **irreversible**.

Model versions with related active prediction jobs or endpoints can not be deleted.

### Model Version Deletion via the SDK

To delete a Model Version, you can call the `delete_model_version()` function from Merlin Python SDK.

```python
merlin.set_project("test-project")

merlin.set_model('test-model')

version = merlin.active_model().get_version(id_version)

version.delete_model_version()
```

### Model Version Deletion via the UI

To delete a model version from the UI, you can access the delete button directly on the model version list page. The dialog will provide information about entities that are blocking the deletion process or will be deleted along with the model version.

* If the model version does not have any associated entities, a dialog like the one below will be displayed: ![Delete Model Version without linked entites](https://2689420226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMRO0BquZrbmgj6RBGJL%2Fuploads%2Fgit-blob-0be99e694ba61a96afad9e6315a330501981ad9c%2Fdelete_model_version_no_entity.png?alt=media)
* If the model version has any associated active entities, a dialog like the one below (showing the entities blocking the deletion process) will be displayed: ![Delete Model Version with linked active entites](https://2689420226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMRO0BquZrbmgj6RBGJL%2Fuploads%2Fgit-blob-23ef127201d10db8a1d499e61ee3969dfbcb888d%2Fdelete_model_version_active_entity.png?alt=media)
* If the model version has any associated inactive entities, a dialog like the one below (showing which entities will get deleted along with the deletion process) will be displayed: ![Delete Model Version with linked inactive entites](https://2689420226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMRO0BquZrbmgj6RBGJL%2Fuploads%2Fgit-blob-7537bdd64a9ee4ef20f0aad872326479e4862cfd%2Fdelete_model_version_inactive_entity.png?alt=media)

## Model Deletion

{% hint style="info" %}
This feature is currently behind a toggle and may or may not be enabled on the Merlin controller, by the maintainers.
{% endhint %}

A Merlin model can be deleted only if it is not serving any endpoints and does not have any deployed model versions or, if the model is of the `pyfunc_v2` type, none of its model versions must not have any active prediction jobs. Deleting a model will result in the purging of all the model versions associated with it, as well as related entities such as endpoints or prediction jobs (applicable for models of the `pyfunc_v2` type) from the Merlin database. This action is **irreversible**.

A model with model versions that have any active prediction jobs or endpoints cannot be deleted.

### Model Deletion Via the SDK

To delete a Model, you can call the `delete_model()` function from the Merlin Python SDK.

```python
merlin.set_project("test-project")

merlin.set_model('test-model')

model = merlin.active_model()

model.delete_model()
```

### Model Deletion via the UI

To delete a model from the UI, you can access the delete button directly on the model list page. The dialog will provide information about any entities that are blocking the deletion process.

* If the model does not have any associated entities, a dialog like the one below will be displayed: ![Delete Model without linked entites](https://2689420226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMRO0BquZrbmgj6RBGJL%2Fuploads%2Fgit-blob-53782b5d0b02bf8f42bc86acb97e1db2316ed7a6%2Fdelete_model_no_entity.png?alt=media)
* If the model has any associated active entities, a dialog like the one below will be displayed: ![Delete Model with linked active entites](https://2689420226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMRO0BquZrbmgj6RBGJL%2Fuploads%2Fgit-blob-6ecc0908cc2c9db711571c95333151bc37d74bdd%2Fdelete_model_active_entity.png?alt=media)