Skip to main content

Team Management & IAM

Overview

Team Management lets you share access to your account with colleagues while maintaining full control over what each person can see and do. Invite team members by email, assign roles with granular permissions, and optionally fine-tune access per project.

Key capabilities:

  • Email invitations -- Invite team members with secure signed links that expire after 72 hours.
  • Built-in roles -- Three predefined roles covering common access patterns: Admin, Operator, and Viewer.
  • Custom roles -- Create roles with any combination of View, Manage, and Delete permissions across 15 service groups.
  • Project-level overrides -- Fine-tune a member's permissions within specific projects without changing their overall role.
  • API token scoping -- Team members' API tokens inherit their role permissions automatically.

Inviting Team Members

  1. Navigate to Organization > Team Members in the sidebar.
  2. Click Invite Member.
  3. Enter the team member's email address and select a role.
  4. Click Invite.

The invitee receives an email with a link to set their name and password. Once accepted, they can log in at the same URL as the account owner.

Managing Members

From the Team Members page you can:

  • Edit Role -- Change a member's assigned role at any time.
  • Resend Invite -- Resend the invitation email for members who haven't accepted yet.
  • Remove -- Remove a member from your account. They lose all access immediately.

Built-In Roles

Viewer (Read-Only)

Can view all resources, metrics, configurations, and billing information. Cannot create, modify, or delete anything. Does not have access to Team Management or API Tokens.

Operator (View + Manage)

Full operational control -- can create instances, configure load balancers, manage security groups, set up monitoring alerts, and perform all day-to-day tasks. Cannot delete any resources, protecting against accidental destruction. Cannot manage billing, team members, or API tokens.

Admin (Full Access)

Complete control over the account including all resource operations, team member management, role creation, and API token management. The only restriction: Admins cannot remove the account owner.

Custom Roles

For access patterns not covered by built-in roles, create custom roles with any combination of permissions.

  1. Navigate to Organization > Roles.
  2. Click Create Role.
  3. Enter a name and optional description.
  4. For each service group, toggle the permissions you want to grant:
    • View -- Read-only access
    • Manage -- Create and modify resources
    • Delete -- Destroy resources
  5. Click Create Role.

Permission Groups

GroupViewManageDelete
Compute -- InstancesView instances, metrics, SSH, consoleCreate, power control, resize, reinstall, networkingDestroy instances
Networking -- VPCsView VPCs, subnets, NAT/VPN gatewaysCreate and modify all networking resourcesDelete VPCs and sub-resources
Networking -- Load BalancersView LBs, configs, metricsCreate and modify LBs, SSL, health checksDelete load balancers
Networking -- Security GroupsView groups, rules, IP setsCreate and modify rules, IP setsDelete groups and rules
DatabasesView databases, configs, backupsCreate, modify, restart, manage replicas/backupsDelete databases and backups
Object StorageView buckets and access keysCreate and modify buckets/keysDelete buckets
Images & ISOsView custom imagesCreate images from instancesDelete images
Static IPsView allocationsAllocate and assign IPsDeallocate IPs
AutoscalingView groups and policiesCreate and modify scaling rulesDelete groups
BillingView credits, usage, invoicesManage billing settings--
SSH KeysView keysCreate and edit keysDelete keys
User ScriptsView scriptsCreate and edit scriptsDelete scripts
ProjectsView projectsCreate, edit, assign resourcesDelete projects
Monitoring & AlertsView dashboard, alerts, historyCreate/edit alert rules and channels--
Team ManagementView members and rolesInvite/remove members, manage roles--
API Tokens--Create and revoke tokens--

Project-Level Overrides

You can override a member's role permissions for specific projects. This is useful when a team member needs different access levels across environments.

Example: A Developer role member might have Operator access on the "Development" project but Viewer-only on "Production".

To set an override:

  1. Open the project detail page.
  2. Go to the Members tab.
  3. Click Override Permissions next to a team member.
  4. Toggle the permissions for this project.
  5. Click Save Override.

Remove the override at any time to revert to the member's role-based permissions.

How Permissions Are Enforced

  • Server-side enforcement -- Every API endpoint checks the acting user's permissions before executing. Hidden UI elements are backed by middleware checks.
  • Resource scoping -- Team members see the account owner's resources, not their own. All resources belong to the account.
  • Audit trail -- Task logs record which user initiated each action, even when that user is a team member.
  • API tokens -- Tokens created by team members inherit the member's role permissions. A Viewer's API token can only perform read operations.