---
title: "Create classifications model"
method: POST
path: "/v1/models/classifications"
tags: ["Manage classifications models"]
---

# Create classifications model

`POST /v1/models/classifications`

Creates a custom classifications model by uploading training data and associated metadata. The model begins the training and deploying process and is ready to use when the `status` is `available`.

## Response `201`

Model created successfully

- 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)