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

- **2026-07-17** `a1e12cbeeebc` — 20 info
  - added the new optional request property `endpoints/items/environment/default_resource_request/liveness_probe`
  - added the new optional request property `endpoints/items/environment/default_resource_request/readiness_probe`
  - added the new optional request property `endpoints/items/environment/default_transformer_resource_request/liveness_probe`
  - added the new optional request property `endpoints/items/environment/default_transformer_resource_request/readiness_probe`
  - …16 more
- **2024-12-05** `14228a52f169` — 2 info
  - added the new optional request property `endpoints/items/model_observability`
  - added the optional property `endpoints/items/model_observability` to the response with the `201` status
- **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
- …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)