Skip to main content
POST
Soft-restart the worker fleet

Authorizations

x-api-key
string
header
required

Body

application/json

A fleet reload-config request — an optional targets list restricting the soft-restart to named workers (all workers when omitted).

targets
string[] | null

Response

Success.

data
FleetResult · object
required

The awaited result of one :meth:WorkerBus.publish.

Two honest shapes. Reachable (reachable=True): results holds, per worker, the expected workers' verdicts (the synthesized self entry included) AND the gap rows (resyncing / recycling / stale) for rows that failed the ready+ fresh gate — each carried as its actual condition rather than dropped. Bus-unreachable (reachable=False): the transport failed before any worker could reply, so there is NO worker list — only error. local_only marks the result of the no-op :meth:WorkerBus.local variant.