admin

Google Admin via Google Workspace CLI

Use gws admin to manage Google Workspace domain administration from the command line.

Note: Admin operations require Google Workspace admin privileges.

Common Operations

Users

# List users in the domain
gws admin users list

# List with pagination
gws admin users list --limit 100

# Get a specific user
gws admin users get "[email protected]"

# Create a user
gws admin users create \
  --email "[email protected]" \
  --given-name "New" \
  --family-name "User" \
  --password "temporary-password"

# Update a user
gws admin users update "[email protected]" \
  --given-name "Updated"

# Suspend a user
gws admin users update "[email protected]" --suspended true

# Unsuspend a user
gws admin users update "[email protected]" --suspended false

# Delete a user
gws admin users delete "[email protected]"

Groups

# List groups
gws admin groups list

# Get group details
gws admin groups get "[email protected]"

# Create a group
gws admin groups create \
  --email "[email protected]" \
  --name "Team" \
  --description "Team group"

# Add a member to a group
gws admin groups members add "[email protected]" --email "[email protected]" --role "MEMBER"

# List group members
gws admin groups members list "[email protected]"

# Remove a member
gws admin groups members remove "[email protected]" --email "[email protected]"

# Delete a group
gws admin groups delete "[email protected]"

Organizational Units

# List organizational units
gws admin orgunits list

# Create an organizational unit
gws admin orgunits create --name "Engineering" --parent "/"

# Move a user to an OU
gws admin users update "[email protected]" --org-unit "/Engineering"

Roles

Role	Description
OWNER	Group owner
MANAGER	Group manager
MEMBER	Regular member

Tips

• Admin API requires domain admin or delegated admin credentials
• User operations use primary email as the identifier
• Use --format json for structured output
• Bulk operations should use batch requests when available