Team Management

Note: Team management features are not yet available in the private beta. This documentation is provided for reference and will be activated when the feature launches.

Collaborate on FastAPI Cloud by creating teams to invite teammates and manage your applications together.

Personal vs Team Accounts

When you sign up for FastAPI Cloud, you get a personal team by default. This team is tied to your user account and it’s meant for individual projects. Personal teams cannot be deleted, have additional members added, or have ownership transferred.

To collaborate with others you can create a new team.

Create a Team

To create a new team you just need to:

1. Click on the team switcher in the top-left corner.
2. Select Add Team.
3. Enter a team name and click Create Team.

Choose a name that makes sense for your organization and we’ll assign a team slug based on the name you choose. This slug will be used in URLs in the dashboard and will be unique across all teams.

After creating your team, you’ll be directed to Settings where you can invite members and manage your team.

Team Roles

Teams have two roles (Admin and Member) plus a special Owner designation. The owner is always an admin, but has additional privileges. Each role has different permissions:

Permissions Matrix

Action	Owner	Admin	Member
View team	✓	✓	✓
Access team applications	✓	✓	✓
Update team settings	✓	✓	✗
Invite members	✓	✓	✗
Remove members	✓	✓ (except owner)	✗
Change roles	✓	✓ (except owner)	✗
Transfer ownership	✓	✗	✗
Delete team	✓	✗	✗

Owner

The team owner is a special designation for the user who created the team or received ownership via transfer. The owner:

• Has full control over the team.
• Can transfer ownership to another admin.
• Can delete the team.
• Cannot be removed from the team.
• Cannot have their role changed by other admins.
• Has all admin permissions.

Admin

• Can invite and remove members (except the owner).
• Can change member roles (promote/demote between admin and member, except for the owner).
• Can update team settings.
• Has all member permissions.

Member

• Can view team information.
• Can access and deploy team applications.
• Cannot modify team settings or manage members.

Inviting Team Members

Admins can invite new members via email:

1. Go to Settings.
2. Click Invite Member in the Team Members section.
3. Enter your teammate’s email address.
4. They’ll receive an invitation to join.

Invitations appear in the Pending tab until accepted. Once accepted, new members appear in the Active tab with the member role by default. They’ll have seven days to accept the invitation before it expires.

Managing Team Members

Admins can manage existing team members:

Change Role

• Promote members to admin for management permissions.
• Demote admins to member to restrict permissions.

Remove User

• Revokes all access to the team.
• All associated data and permissions are permanently removed.
• User must be invited again to restore access.

Transferring Ownership

Team owners can transfer ownership to another admin. To transfer, ensure at least one other admin exists, then:

1. Go to Settings.
2. Click Transfer Ownership.
3. Select the new owner from the dropdown.
4. Confirm the transfer.

Deleting a Team

Only the team owner can permanently delete teams. Once deleted, all data and applications associated with the team will be lost. To delete a team:

1. Go to Settings.
2. Scroll to the Danger Zone section.
3. Click Delete Team.
4. Follow the confirmation steps.
5. Confirm deletion.