---
title: "Create a model. WARNING: This API is experimental and will change in future versions."
method: POST
path: "/models"
tags: ["RegisteredModels"]
---

# Create a model. WARNING: This API is experimental and will change in future versions.

`POST /models`

## Request

- Base URL: `http://localhost:8080/api/2.1/unity-catalog`
- URL: `http://localhost:8080/api/2.1/unity-catalog/models`
- Auth: none declared

Creates a new model instance.
WARNING: This API is experimental and will change in future versions.

## Request body

- CreateRegisteredModel
  - `name` string, required: Name of model, relative to parent schema.
  - `catalog_name` string, required: Name of parent catalog.
  - `schema_name` string, required: Name of parent schema relative to its parent catalog.
  - `comment` string: User-provided free-form text description.

## Response `200`

The new registered model was successfully created.

- RegisteredModelInfo
  - `name` string: The name of the registered model
  - `catalog_name` string: The name of the catalog where the schema and the registered model reside
  - `schema_name` string: The name of the schema where the registered model resides
  - `storage_location` string: The storage location on the cloud under which model version data files are stored
  - `full_name` string: The three-level (fully qualified) name of the registered model
  - `comment` string: The comment attached to the registered model
  - `owner` string: The identifier of the user who owns the registered model
  - `created_at` integer: Creation timestamp of the registered model in milliseconds since the Unix epoch
  - `created_by` string: The identifier of the user who created the registered model
  - `updated_at` integer: Last-update timestamp of the registered model in milliseconds since the Unix epoch
  - `updated_by` string: The identifier of the user who updated the registered model last time
  - `id` string: Unique identifier for the registered model.

## Changes

- **2024-09-12** `2dd9fd4253e0`: 1 warning, 2 info
  - removed the optional property `model_id` from the response with the `200` status
  - added the optional property `id` to the response with the `200` status
  - added the optional property `owner` to the response with the `200` status
- **2024-08-22** `a51b73b68a9f`: 1 breaking, 1 warning
  - added the new required request property `name`
  - removed the request property `model_name`
- **2024-08-12** `6fd9940ca119`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/models/post.md)

---

[API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) - [All operations](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/revisions/c84507f0d7e0?raw)