Skip to content

ironflow tenant

Provision and list tenant organizations. Tenants provide multi-tenancy by atomically creating an organization, built-in roles, and a default environment.

Terminal window
ironflow tenant <subcommand> [flags]

Subcommands:

SubcommandDescription
provisionProvision a new tenant organization
listList all tenants

Atomically create an organization, built-in roles, and a default environment.

Terminal window
ironflow tenant provision [flags]

Flags:

FlagShortTypeDefaultDescription
--namestringOrganization name (required)
--envstringEnvironment name (default: production)
--server-sstringServer URL override

Output:

Created org: Acme Corp (org_abc123)
Created env: production (env_def456)
Admin API Key: ak_abc123...

Examples:

Terminal window
# Provision a new tenant with default environment
ironflow tenant provision --name "Acme Corp"
# Provision with a custom environment name
ironflow tenant provision --name "Acme Corp" --env staging

List all tenant organizations with their environment and key counts.

Terminal window
ironflow tenant list [flags]

Flags:

FlagShortTypeDefaultDescription
--jsonboolfalseOutput as JSON
--server-sstringServer URL override

Output:

ID NAME ENVS KEYS CREATED
org_abc123 Acme Corp 1 2 2026-01-01T00:00:00Z
org_def456 Widget Inc 2 3 2026-02-15T00:00:00Z

Examples:

Terminal window
ironflow tenant list
ironflow tenant list --json