Sign in
LinkMablnet

Inspect a channel's rollout state (operator)

Returns the current rollout state for the channel the given version belongs to. Rollout state is keyed by channel, so channel is a required query parameter that disambiguates which channel's state to read. Operator-only.

get/link/mablnet/artifacts/{artifact}/releases/{version}/rollout

Path parameters

artifactstring required

Release artifact the channel belongs to: mablnet-host (the worker binary) or link-agent (the Java Link Agent bundle). Channels are namespaced per artifact, so stable for one artifact is unrelated to stable for another.

versionstring required

Release version whose channel rollout is being inspected.

Query parameters

channelstring required

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

Response

Current rollout state for the channel.

idstring

Datastore key for this entity — <artifact>/<channel> (one entity per artifact + channel). Server-set.

artifactstring required

Release artifact this state governs (mablnet-host, link-agent).

channelstring required

Release channel this state governs, within artifact.

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.

Changes

Changed in 1 of the 32 revisions of this API.1