oz0 kill agent

Stop an agent or a flow (NAME, or <plugin>/<agent>): no new jobs, no model calls, running jobs paused or cancelled

For: Operators and developers looking up a command.

Stop an agent or a flow (NAME, or <plugin>/<agent>): no new jobs, no model calls, running jobs paused or cancelled

Usage

oz0 kill agent NAME [flags]

Flags

FlagTypeDefaultDescription
--decision-refstringthe decision or case the change follows, such as a case number (at most 200 characters)
--jsonboolprint JSON instead of a table
--modestringparkwhat happens to running jobs: park (pause; they resume on release) or cancel
--reasonstringwhy, for the audit log (required)

Inherited flags

FlagTypeDefaultDescription
--contextstring$OZ0_CONTEXT or <config dir>/orchestrator-zero/context.jsonCLI context file written by server init
--log-levelstringinfolog level: debug, info, warn or error
--tenantstringdefaultthe tenant

See all oz0 commands and the global flags.

On this page
Copyright © 2026