oz0 subject object

Record a person's objection to processing for one purpose (a purpose ID of the tenant's, as `run --purpose` names it).

For: Operators and developers looking up a command.

Record a person's objection to processing for one purpose (a purpose ID of the tenant's, as run --purpose names it). A job about them that names the purpose is refused, and so is one that names no purpose when its agent declares this one (it may be for it); jobs for other purposes run. Their running jobs that named the purpose are cancelled within seconds. --lift ends the objection, as a governance change with a reason. The tenant's admins may.

Usage

oz0 subject object SUBJECT --purpose PURPOSE --reason REASON [flags]

Flags

FlagTypeDefaultDescription
--jsonboolprint JSON instead of a table
--liftboollift the objection instead (another admin may need to approve it)
--purposestringthe purpose the person objects to (required)
--reasonstringwhy, such as the request it answers (required; default $OZ0_REASON; 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