oz0 tenant labels

A job's labels have a trust part, untrusted once it read outside input, and a confidentiality part: a level from this ordered list (lowest first) and compartments.

For: Operators and developers looking up a command.

A job's labels have a trust part, untrusted once it read outside input, and a confidentiality part: a level from this ordered list (lowest first) and compartments. A tool result declares its level in its _meta (oz0/labels); a level the list does not hold withholds the result. An unlabelled result of a tool whose manifest declares a label source (labels.source) gets the default level, never the lowest. Rules read the level as job.labels.level (its index, so >= works) and job.labels.level_name.

--trusted names open-world functions the tenant vouches for: their results count as trusted, so they do not taint a job. Without flags it shows the settings. A change needs --reason (or $OZ0_REASON); emptying the list (--builtin), dropping or moving down a level, lowering the default level or vouching for a function loosens, and waits for another admin where four eyes is on.

Usage

oz0 tenant labels <tenant> [flags]
oz0 tenant labels [command]

Subcommands

Flags

FlagTypeDefaultDescription
--builtinboolgo back to the built-in levels (public, internal, confidential, restricted)
--decision-refstringthe decision or case the change follows, such as a case number (at most 200 characters)
--default-levelstringthe level of an unlabelled result of a tool that declares a label source
--jsonboolprint JSON instead of a table
--levelsstringsthe levels, lowest first, comma-separated (at most 8)
--reasonstringwhy, required for every governance change (at most 500 characters; default $OZ0_REASON); the audit log keeps it
--trustedstringsopen-world functions whose results count as trusted, <tool>.<function> with * (empty to clear)

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

See all oz0 commands and the global flags.

Copyright © 2026