oz0 inventory purposes set

Usage and flags for oz0 inventory purposes set.

For: Operators and developers looking up a command.

Replace the tenant's lists: --legal-basis ID=DESCRIPTION and --purpose ID=DESCRIPTION, each repeatable (IDs are lowercase letters, digits and . _ -), and --purpose-basis PURPOSE=BASIS to give a purpose a legal basis from the list. What the command does not name is removed, so give the whole lists.

Giving, changing or removing a purpose's legal basis, or the description of a basis a purpose or an agent names, is a governance change: it takes --reason (or $OZ0_REASON), and changing or removing one waits for another admin while four eyes is on. If the lists change while it waits, its approval is refused and the change is requested again.

Usage

oz0 inventory purposes set [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
--legal-basisstringArraya legal basis of the tenant's list, as ID=DESCRIPTION (repeatable)
--purposestringArraya purpose of the tenant's list, as ID=DESCRIPTION (repeatable)
--purpose-basisstringArraya purpose's legal basis, as PURPOSE=BASIS (repeatable)
--reasonstringwhy, required for every governance change (at most 500 characters; default $OZ0_REASON); the audit log keeps it

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