teactl member

Manage organization members. Members are users who have access to an organization and its projects.

Synopsis

teactl member <command> [flags]

Commands

teactl member list

List all members in an organization.

teactl member list [flags]

Flags:

Example:

$ teactl member list

EMAIL                    NAME              ROLE     STATUS    JOINED
[email protected]          Alice Admin       admin    active    2024-01-15
[email protected]            Bob Developer     member   active    2024-01-20
[email protected]            -                 member   pending   2024-03-01

Filter by role:

$ teactl member list --role admin

EMAIL                    NAME              ROLE     STATUS    JOINED
[email protected]          Alice Admin       admin    active    2024-01-15
[email protected]            Carol Ops         admin    active    2024-02-10

teactl member get

Get detailed information about a member.

teactl member get <email> [flags]

Arguments:

Example:

$ teactl member get [email protected]

Member: [email protected]
Name:   Bob Developer
ID:     user_abc123
Role:   member
Status: active
Joined: 2024-01-20 09:15:00

Activity:
  Last login:      2024-03-10 14:30:00
  Environments:    23 created
  Last active:     2024-03-10 16:45:00

Projects:
  - default (full access)
  - training (full access)
  - production (read-only)

teactl member invite

Invite a new member to the organization.

teactl member invite <email> [flags]

Arguments:

Flags:

Example:

# Invite as member (default role)
$ teactl member invite [email protected]

Invitation sent to [email protected]
Role: member
Expires: 2024-03-17 (7 days)

The user will receive an email with instructions to join.

Invite as admin:

$ teactl member invite [email protected] --role admin

Invitation sent to [email protected]
Role: admin
Expires: 2024-03-17 (7 days)

With custom message:

$ teactl member invite [email protected] --message "Welcome to the team! Please set up your account to access our training environments."

Invitation sent to [email protected]

teactl member update

Update a member’s role.

teactl member update <email> [flags]

Arguments:

Flags:

Example:

# Promote to admin
$ teactl member update [email protected] --role admin

Member '[email protected]' updated.
New role: admin

Demote from admin:

$ teactl member update [email protected] --role member

Member '[email protected]' updated.
New role: member

teactl member remove

Remove a member from the organization.

teactl member remove <email> [flags]

Arguments:

Flags:

Example:

$ teactl member remove [email protected]

Remove '[email protected]' from organization 'acme-corp'?
This will revoke all access to organization resources. [y/N]: y

Member '[email protected]' removed from organization.

teactl member resend

Resend an invitation to a pending member.

teactl member resend <email> [flags]

Arguments:

Example:

$ teactl member resend [email protected]

Invitation resent to [email protected]
New expiration: 2024-03-17 (7 days)

Member Roles

Teabar has a simple role model:

Admin Capabilities

• Invite and remove members
• Change member roles
• Create and delete projects
• Access all projects and environments
• Manage organization settings
• View billing and usage

Member Capabilities

• Create environments in accessible projects
• Manage own environments
• View project resources
• Cannot manage members or organization settings

Bulk Operations

Invite multiple members at once using a file:

# Create a file with emails (one per line)
$ cat invites.txt
[email protected]
[email protected]
[email protected]

# Invite all
$ cat invites.txt | xargs -I {} teactl member invite {}

Global Flags

These flags work with all member commands:

See Also

• teactl org - Manage organizations
• teactl project - Manage projects
• Administration: Members - Web console member management
• Organizations Concept - Understanding organizations and members