---
title: "Finalize a model version"
method: PATCH
path: "/models/{full_name}/versions/{version}/finalize"
tags: ["ModelVersions"]
---

# Finalize a model version

`PATCH /models/{full_name}/versions/{version}/finalize`

## Request

- Base URL: `http://localhost:8080/api/2.1/unity-catalog`
- URL: `http://localhost:8080/api/2.1/unity-catalog/models/{full_name}/versions/{version}/finalize`
- Auth: none declared

Finalizes the status of the specified model version.

## Request body

- FinalizeModelVersion
  - `full_name` string, required: The full name of the registered model to finalize.
  - `version` integer, required: Version number of the version to finalize.

## Response `200`

The model version was successfully finalized.

- ModelVersionInfo
  - `model_name` string: The name of the parent registered model of the model version, relative to parent schema
  - `catalog_name` string: The name of the catalog containing the model version
  - `schema_name` string: The name of the schema containing the model version, relative to parent catalog
  - `version` integer: Integer model version number, used to reference the model version in API requests.
  - `source` string: URI indicating the location of the source artifacts (files) for the model version
  - `run_id` string: The run id used by the ML package that generated the model.
  - `status` 'MODEL_VERSION_STATUS_UNKNOWN' | 'PENDING_REGISTRATION' | 'FAILED_REGISTRATION' | 'READY': All possible model version statuses.
  - `storage_location` string: The storage location on the cloud under which model version data files are stored
  - `comment` string: The comment attached to the model version
  - `created_at` integer: Time at which this model version was created, in epoch milliseconds.
  - `created_by` string: The identifier of the user who created the model version
  - `updated_at` integer: Time at which this model version was last modified, in epoch milliseconds.
  - `updated_by` string: The identifier of the user who updated the model version last time
  - `id` string: Unique identifier for the model version.

## Changes

- **2024-09-12** `2dd9fd4253e0`: 1 warning, 1 info
  - removed the optional property `model_version_id` from the response with the `200` status
  - added the optional property `id` to the response with the `200` status
- **2024-08-27** `20b40ddf5893`: 1 breaking, 3 warning
  - added the new required request property `full_name`
  - removed the request property `catalog_name`
  - removed the request property `model_name`
  - removed the request property `schema_name`

[Operation history](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/models/:full_name/versions/:version/finalize/patch.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)