Promote Version

Page Outline

• Path Parameters
• Behavior
• Response

---

Marks a specific model version as the promoted (production) version. Only one version can be promoted at a time — promoting a new version automatically demotes the previous one.

Base Path: /api/v1/models

Method: POST

Path: /{model_id}/versions/{version_id}/promote

Auth: Requires a valid Bearer token (Authorization: Bearer <JWT>)

Path Parameters

Parameter	Type	Description
model_id	string	Unique identifier of the parent model
version_id	string	Unique identifier of the version to promote

Behavior

• Only versions with status: "ready" can be promoted. Promoting a failed or in-progress version returns HTTP 422 Unprocessable Entity.
• The previously promoted version's is_promoted flag is automatically set to false.
• Any active deployments referencing the model will begin serving inferences from the newly promoted version after the next routing refresh.
• An audit log entry is written with action model.version_promoted, recording the previous and new version IDs.
• Returns HTTP 404 if the version is not found under the given model.

Response

Returns the updated ModelVersion object with "is_promoted": true.

{
  "version_id": "ver-002",
  "model_id": "mdl-7f3a19bc",
  "version_number": 2,
  "is_promoted": true,
  "promoted_at": "2026-03-13T16:10:00Z",
  "promoted_by": "user-001"
}