# Deleting a Model

#### Function

This API is used to delete a model based on the model ID. When cascade is set to true, the model specified by the model ID and models of different versions with the same name as the specified model are deleted. By default, only the model with the specified model ID is deleted.

#### URI

DELETE /v1/{project_id}/models/{model_id}

Table 1 describes the required parameters.

Table 1 Parameter description
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
project_id | Yes | String | Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
model_id | Yes | String | ID of the model to be deleted

Table 2 Parameter description
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
cascade | No | Boolean | The default value is false, indicating that only the model with the specified model ID is deleted. The value true indicates that not only the model with the specified model ID but also all models with the same name but different versions as the specified model will be deleted. A maximum of 20 models can be deleted at a time.

#### Request Body

None

#### Response Body

Table 3 describes the response parameters.

Table 3 Parameter description
Parameter | Type | Description
--- | --- | ---
delete_success_list | String array | ID list of models successfully deleted
delete_failed_list | DeleteModelFailResult array | List of models that fail to be deleted. For details, see Table 4.

Table 4 DeleteModelFailResult parameters
Parameter | Type | Description
--- | --- | ---
model_id | String | ID of a model that fails to be deleted
error_code | String | Error code of the deletion failure
error_message | String | Error message of the deletion failure

#### Samples

The following shows how to delete the model whose ID is 023e90be-7e2a-4169-bab4-1bc34ff0ca45 and all models of the same name but different versions.

- Sample request

      DELETE    https://endpoint/v1/{project_id}/models/023e90be-7e2a-4169-bab4-1bc34ff0ca45?cascade=true

- Sample response

      {
      "delete_success_list": ["fc9e88a1-0005-40b3-867e-7aee61449aeb", "f3f3ba0e-f073-454e-9e3f-14b7d786f45e"],
      "delete_failed_list": [
      {
      "model_id": "759645d9-3672-4db1-bb6d-49ed58b84e10",
      "error_code": "ModelArts.3009",
      "error_message": "Failed to delete model, model (759645d9-3672-4db1-bb6d-49ed58b84e10) already deploy service."
      }]
      }

#### Status Code

For details about the status code, see Table 1.

#### Error Codes

See Error Codes.

Parent topic: Model Management