Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

LinkMablnet

Force a channel's current version — rollback / pin (operator)

Republishes an already-stored version as the channel's current — the rollback / pinning primitive. By default the forced version inherits a staged rollout; pass a single-stage rollout_schedule of [{percent: 100, since_ms: 0}] for an immediate fleet-wide swap. Operator-only. See design doc § Operator commands.

put/link/mablnet/channels/{channel}/current

Path parameters

channelstring required

Channel whose current version is being forced.

Request body

versionstring required

The already-stored release version to make current on this channel.

Response

Updated rollout state for the channel.

idstring

Datastore key for this entity — equals channel (one entity per channel). Server-set.

channelstring required

Release channel this state governs.

current_versionstring required

The version being rolled out to (Hosts inside the rolled-out percentage receive this).

fallback_versionstring

What Hosts not yet inside the rollout receive. Unset once a rollout reaches 100% and the current version is fully rolled out.

force_percentinteger

When set, overrides the time-based schedule with an explicit rolled-out percentage (operator force-advance). Cleared by resuming the schedule.

published_atstring date-time

When the current rollout started; the schedule's since_ms offsets are relative to this.

pausedboolean required

When true, the manifest endpoint stops advancing the rollout — Hosts stay on whichever version they have.