---
title: "Log a new version of the models"
method: POST
path: "/models/{model_id}/versions"
tags: ["version"]
---

# Log a new version of the models

`POST /models/{model_id}/versions`

## Path parameters

- `model_id` integer, required

## Response `201`

Created

## Changes

> 34 revisions in range; 4 not diffed, 2 could not be searched.

- **2024-03-01** `d877210ee347` — 4 breaking, 4 warning, 8 info
  - added the new required request property `model_schema/spec/model_prediction_output/oneOf[#/components/schemas/BinaryClassificationOutput]/actual_score_column`
  - the request property `model_schema/spec/model_prediction_output/oneOf[#/components/schemas/RegressionOutput]/actual_score_column` became required
  - removed the required property `model_schema/spec/model_prediction_output/oneOf[#/components/schemas/RankingOutput]/prediction_group_id_column` from the response with the `201` status
  - removed the required property `model_schema/spec/prediction_id_column` from the response with the `201` status
  - …12 more
- **2024-01-26** `ab97b531bbc1` — 3 breaking, 3 info
  - the request property `model_schema/spec/model_prediction_output/oneOf[#/components/schemas/BinaryClassificationOutput]/output_class` became required
  - the request property `model_schema/spec/model_prediction_output/oneOf[#/components/schemas/RankingOutput]/output_class` became required
  - the request property `model_schema/spec/model_prediction_output/oneOf[#/components/schemas/RegressionOutput]/output_class` became required
  - the response property `model_schema/spec/model_prediction_output/oneOf[#/components/schemas/BinaryClassificationOutput]/output_class` became required for the status `201`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/caraml-dev/apis/merlin/changes/models/:model_id/versions/post.md)

---

[API](https://skmtc.dev/caraml-dev/apis/merlin.md) · [All operations](https://skmtc.dev/caraml-dev/apis/merlin/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/caraml-dev/merlin/revisions/a1e12cbeeebc/schema)