Skip to main content
POST
Roll an alias back

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 roll back (default flow: production)

Body

application/json

Optional reason

reason
string | null

Optional reason; defaults to naming the audit row being undone.

Response

The alias now points at the previous 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).