Skip to main content
POST
Promote a version (move an alias)

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Path Parameters

name
string
required

Lineage name

alias
string
required

Alias to move (production, staging, or custom)

Body

application/json
version
string
required

The version to point the alias at: "v6" or "6".

reason
string
required

Why (required): recorded verbatim in the audit trail.

Response

The alias now points at the version

The result of a promote or rollback.

object
string
required

Always "model_alias_move".

model
string
required
alias
string
required
to_version
integer<int32>
required
version
object
required

The version the alias now resolves to.

audit
object
required

One audited alias move.

fleet_flips_staged
integer
required

Multi-adapter fleets serving this lineage on which a flip to the new version was staged (production moves only). The fleet cuts over once every replica has the version loaded — no redeploy.

Required range: x >= 0
from_version
integer<int32> | null

The version the alias pointed at before (absent when the alias was created).