oz0 inventory retire

Retire an agent, a flow or a tool (G11).

For: Operators and developers looking up a command.

Retire an agent, a flow or a tool (G11). New jobs of a retired agent are refused, by StartJob, routines, webhooks, event routes and delegations, with the fix; a retired tool's calls are refused on the nodes as a stopped tool's. Jobs that run finish. Removing a plugin retires its agents and tools; installing it again brings back what the removal retired. Audited inventory.retired.

Usage

oz0 inventory retire agent|tool NAME [flags]

Flags

FlagTypeDefaultDescription
--jsonboolprint JSON instead of a table
--reasonstringwhy it is retired (required, at most 500 characters)

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