forge org create
Create a new organisation (tenant) via CLI.
Command
forge org create <name> [--slug <slug>] [--region <region>]
Arguments
| Name | Type | Required | Notes |
|---|---|---|---|
| string | yes | Display name for the organisation |
Flags
| Flag | Type | Default | Notes |
|---|---|---|---|
| string | derived | Auto-derived from name if not provided |
| enum | | |
Examples
Basic:
forge org create "My Company"
# → Created org "My Company" (slug: my-company)
# → Org ID: org_xxxxx
With custom slug:
forge org create "My Company" --slug my-corp --region us
Errors
| Exit code | Meaning |
|---|---|
| 0 | Created successfully |
| 1 | Invalid input (name empty, bad region) |
| 2 | Auth failure (no key, invalid key) |
| 3 | Conflict (slug already in use) |
Pitfalls
- Slug uniqueness — slugs must be globally unique. Auto-derived slugs may collide; pass
explicitly if needed.--slug - Org limits — Free plan: 1 org. Upgrade to create additional orgs.
See also
{auto-injected}
Tested against
{auto-injected}