teactl org

Manage organizations. Organizations are the top-level container for projects, environments, and members.

Synopsis

teactl org <command> [flags]

Commands

teactl org list

List all organizations you are a member of.

teactl org list [flags]

Flags:

Example:

$ teactl org list

NAME          ROLE     PROJECTS   MEMBERS   CREATED
acme-corp     admin    5          12        2024-01-15
training-co   member   2          8         2024-02-20

JSON output:

$ teactl org list -o json

[
  {
    "id": "org_abc123",
    "name": "acme-corp",
    "displayName": "ACME Corporation",
    "role": "admin",
    "projectCount": 5,
    "memberCount": 12,
    "createdAt": "2024-01-15T10:30:00Z"
  }
]

teactl org get

Get detailed information about an organization.

teactl org get [name] [flags]

Arguments:

Example:

$ teactl org get acme-corp

Organization: acme-corp
Display Name: ACME Corporation
ID:           org_abc123
Role:         admin
Projects:     5
Members:      12
Created:      2024-01-15 10:30:00

Plan:         Pro
Usage:
  Environments: 45 this month
  Compute:      1,234 vCPU-hours
  Storage:      500 GB

Billing:
  Contact: [email protected]
  Status:  Active

teactl org create

Create a new organization.

teactl org create <name> [flags]

Arguments:

Flags:

Example:

# Create organization
$ teactl org create my-company --display-name "My Company Inc"

Organization 'my-company' created successfully.

To switch to this organization:
  teactl org switch my-company

To invite members:
  teactl member invite [email protected] --org my-company

teactl org update

Update organization settings.

teactl org update [name] [flags]

Flags:

Example:

$ teactl org update acme-corp --display-name "ACME Corp International"

Organization 'acme-corp' updated.

teactl org delete

Delete an organization and all its resources.

teactl org delete <name> [flags]

Flags:

Example:

$ teactl org delete old-company

WARNING: This will permanently delete:
  - 3 projects
  - 12 environments
  - 5 blueprints
  - 8 member associations

Type 'old-company' to confirm deletion: old-company

Organization 'old-company' deleted.

teactl org switch

Switch your CLI context to a different organization.

teactl org switch <name>

Example:

$ teactl org switch training-co

Switched to organization 'training-co'.
Current context: training-co/default

After switching, all commands will operate in the context of the selected organization.

View current context:

$ teactl config get current-context

Organization: training-co
Project:      default

Global Flags

These flags work with all org commands:

Configuration

Set a default organization to avoid specifying --org on every command:

# Set default organization
teactl config set default-org acme-corp

# Or switch context (sets both org and project)
teactl org switch acme-corp

See Also

• teactl project - Manage projects within organizations
• teactl member - Manage organization members
• teactl config - CLI configuration
• Organizations Concept - Understanding organizations