Agents & Machines
drainMachine
Drain Machine
Drain (or un-drain) one of your machines: the safe way to take a box offline without losing agent work.
Arguments
machineIdstringrequiredWhich machine to drain (machineId from listMachines).drainbooleanoptionaltrue places the drain order (stop claiming + checkpoint every running lane). false lifts it and auto-resumes the runs that checkpointed.
Returns
Queued runs stay queued (they are never failed) and claim again when the machine returns.
Ask for it
The Cloud routes these requests to this verb.
- drain the Mac Mini
- I need to unplug this machine
- pause the fleet on box N
- safe to shut down?
- bring that machine back
Pair it with
The verbs that finish the job.