Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

LinkMablnet

Modify a channel's rollout — pause / resume / force-advance (operator)

Adjusts the in-flight rollout for the channel the given version belongs to: pause or resume the staged schedule, or force the rolled-out percentage to an explicit value (overriding the time-based schedule). Operator-only. See design doc § Operator commands.

patch/link/mablnet/releases/{version}/rollout

Path parameters

versionstring required

Release version whose channel rollout is being modified.

Query parameters

channelstring required

Channel the version belongs to (rollout state is keyed by channel).

Request body

pausedboolean

Pause (true) or resume (false) the staged rollout.

force_percentinteger

Force the rolled-out percentage to this explicit value (0–100), overriding the schedule.

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.