---
title: "Update classifications model"
method: PUT
path: "/v1/models/classifications/{model_id}"
tags: ["Manage classifications models"]
---

# Update classifications model

`PUT /v1/models/classifications/{model_id}`

Overwrites the training data associated with this custom classifications model and retrains the model. The new model replaces the current deployment.

## Response `200`

Model overwrite successful

- ClassificationsModel — The advanced rules feature is deprecated. Existing models are supported until 24 June 2021, but after 10 June 2021, you will not be able to deploy advanced rules models to Natural Language Understanding. After 24 June 2021, advanced rules models will not run in Natural Language Understanding. Advanced rules model
  - `name` string — An optional name for the model
  - `user_metadata` object — An optional map of metadata key-value pairs to store with this model
  - `language` string, required — The 2-letter language code of this model
  - `description` string — An optional description of the model
  - `model_version` string — An optional version string
  - `version` string — Deprecated — use `model_version`
  - `workspace_id` string, nullable — ID of the Watson Knowledge Studio workspace that deployed this model to Natural Language Understanding
  - `version_description` string, nullable — The description of the version
  - `features` string[] — The service features that are supported by the custom model
  - `status` 'starting' | 'training' | 'deploying' | 'available' | 'error' | 'deleted', required — When the status is `available`, the model is ready to use
  - `model_id` string, required — Unique model ID
  - `created` string, date-time, required — dateTime indicating when the model was created
  - `notices` Notice[]
    - `message` string — Describes deficiencies or inconsistencies in training data
  - `last_trained` string, date-time — dateTime of last successful model training
  - `last_deployed` string, date-time — dateTime of last successful model deployment

## Other responses

- `400` — Invalid request
- `403` — Access forbidden

---

[API](https://skmtc.dev/ibm/apis/natural-language-understanding.md) · [All operations](https://skmtc.dev/ibm/apis/natural-language-understanding/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibm/natural-language-understanding/revisions/9a693ab0d5ca/schema)