Skip to main content
POST
Merge env overrides and reload the fleet

Authorizations

x-api-key
string
header
required

Body

application/json

An env write: overrides merged into the stored env, and optionally the whole set of secret marks.

env maps names to string values ("" deletes a name). secret_keys absent or null leaves the stored marks untouched; a list REPLACES them ([] deletes them).

env
Env · object
required
secret_keys
string[] | null

Response

Success.

data
ApplyResponse · object
required

The standard mutation-op response: this worker's local reload result merged with the fleet fan-out summary.

env_keys is the count of env keys the reload loaded. recycle is the fleet recycle roll the change ran — null when it carried no recycle-class key. awaiting_respawn is the operation's verdict: the workers still awaiting a respawn after it (name + keys) — empty when the change rolled a recycle that converged and this worker recycles itself; a worker the roll did not reach, and every listed worker of a change that rolls nothing, keep their keys.