ironflow tenant

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

ironflow tenant <subcommand> [flags]

Subcommands:

Subcommand	Description
provision	Provision a new tenant organization
list	List all tenants

ironflow tenant provision

Create an organization, built-in roles, a default project and environment, and an admin API key. The writes are sequential, not one transaction. If one fails, the server deletes the organization it just created, so you can retry with the same name. If that cleanup fails too, the earlier objects remain and a retry with the same name answers 409.

ironflow tenant provision [flags]

Flags:

Flag	Short	Type	Default	Description
--name		string		Organization name (required)
--env		string		Environment name (default: production)
--server	-s	string	$IRONFLOW_SERVER_URL or http://localhost:9123	Server URL

Output:

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

Examples:

# 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

ironflow tenant list

List all tenant organizations with their environment and key counts.

ironflow tenant list [flags]

Flags:

Flag	Short	Type	Default	Description
--json		bool	false	Output as JSON
--server	-s	string	$IRONFLOW_SERVER_URL or http://localhost:9123	Server URL

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:

ironflow tenant list
ironflow tenant list --json

---