oz0 user grant

Give an account a role in a tenant, replacing the one it had there.

For: Operators and developers looking up a command.

Give an account a role in a tenant, replacing the one it had there. Readers look; operators also start and cancel jobs and decide approvals; admins also change the tenant's nodes, plugins, secrets, tokens and budget; owners also decide who is a member.

Auditors read the audit trail, evidence and governance and change nothing; privacy officers find and erase data subjects and place legal holds; agent users use the agents --agents names in the chat drawer and see their own chats and jobs. --role may name several roles, separated by commas; orchestrator-zero roles lists them with their permissions.

--content says whether the account may see what the tenant's jobs read and wrote; without it, operators and above may, agent users may (they reach only their own chats and jobs), and the others may not.

Usage

oz0 user grant NAME [flags]

Flags

FlagTypeDefaultDescription
--agentsstringsthe agent grant: agents, <plugin>/* or tag:<tag> it may start (agent users start only these)
--contentbooloperators and above, and agent userswhether the account may see what the tenant's jobs read and wrote
--rolestringreader, operator, admin, owner, auditor, privacy-officer, agent-user or a role set's role; several separated by commas
--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