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

- **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
- **2024-01-23** `c3ef0b1c733b` — 1 breaking, 2 info
  - removed the success response with the status `200`
  - added optional request body
  - added the success response with the status `201`
- **2023-12-05** `d062ab20ef25` — 2 breaking, 1 info
  - removed the request body
  - removed the success response with the status `201`
  - added the success response with the status `200`
- **2020-09-28** `c4b3505de7df` — 2 breaking, 1 info
  - removed the request body
  - removed the success response with the status `201`
  - added the success response with the status `200`

[Change 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/ab97b531bbc1/schema)