oz0 roles

A role is a named set of permissions.

For: Operators and developers looking up a command.

A role is a named set of permissions. The built-in roles are reader, operator, admin and owner (each holding what the one before holds), auditor (reads the audit trail, evidence, the inventory and governance, changes nothing), privacy-officer (finds and erases data subjects, places legal holds) and agent-user (uses the agents its membership grants in the chat drawer).

A server started with --role-sets-file or --role-sets-command adds a role set's roles; a role that left the set falls back to the strongest built-in role it held. --permissions lists the permission vocabulary with each permission's level.

Usage

oz0 roles [flags]

Flags

FlagTypeDefaultDescription
--jsonboolprint JSON instead of a table
--permissionsboollist the permission vocabulary with each permission's level
--tenantstringdefaulttenant

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.

On this page
Copyright © 2026