Team Management
Collaborate on FastAPI Cloud by creating teams to invite teammates and manage your applications together.
Hobby vs Pro Teams
Section titled “Hobby vs Pro Teams”When you sign up for FastAPI Cloud, you get a Hobby team by default. Hobby teams are single-seat and meant for individual projects (you can’t invite additional members to them).
To collaborate with other teammates, upgrade to Pro or create a new Pro team.
For plan details, the upgrade flow, and seat management, see Billing.
Create a Team
Section titled “Create a Team”To create a new team:
- Click on the team switcher in the top-left corner.
- Select Add Team.
- 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 is used in URLs across the dashboard and is unique across all teams.
After creating your team, you’ll be directed to Settings where you can manage your team and (once on Pro) invite members.
Team Roles
Section titled “Team Roles”Teams have three roles: Owner, Admin, and Member. A team can have multiple owners. owner is a role you can assign to any team member, not a single special user. The only constraint is that a team must always have at least one owner.
Permissions Matrix
Section titled “Permissions Matrix”Team Permissions
Section titled “Team Permissions”Member management actions (invite, remove, change roles, promote) require a Pro team. Hobby teams are single-seat.
| Action | Owner | Admin | Member |
|---|---|---|---|
| View team | ✓ | ✓ | ✓ |
| Update team settings | ✓ | ✓ | ✗ |
| Invite members | ✓ | ✓ | ✗ |
| Remove members | ✓ | ✓ * | ✗ |
| Change roles | ✓ | ✓ * | ✗ |
| Promote members to owner | ✓ | ✗ | ✗ |
| Manage billing | ✓ | ✓ | ✗ |
| Delete team | ✓ | ✗ | ✗ |
* Admins can only act on other admins and members, not owners.
App Permissions
Section titled “App Permissions”| Action | Owner | Admin | Member |
|---|---|---|---|
| View apps | ✓ | ✓ | ✓ |
| Create apps | ✓ | ✓ | ✓ |
| Update apps config | ✓ | ✓ | ✓ |
| Delete apps | ✓ | ✓ | ✗ |
| Transfer apps | ✓ | ✓ | ✗ |
- Has full control over the team, including billing and deletion.
- Can promote any member or admin to owner, and can demote other owners (as long as at least one owner remains).
- Can delete the team.
- Has all admin permissions.
- Can invite and remove members and other admins.
- Can change roles between member and admin.
- Cannot promote to or demote owners.
- Can update team settings and manage billing.
- Has all member permissions.
Member
Section titled “Member”- Can view team information.
- Can create apps and update application configuration.
- Cannot delete or transfer applications.
- Cannot update team settings or manage members.
Inviting Team Members
Section titled “Inviting Team Members”Admins on a Pro team can invite new members via email:
- Go to Settings.
- In the Members section, click Invite Member.
- Enter your teammate’s email address and select a role.
- They’ll receive an invitation email.
Invitations appear in the Pending tab until accepted. Once accepted, new members appear in the Active tab. Invitations expire after 24 hours. If a teammate misses the window, send a new invitation.
Each accepted invitation consumes one seat against your Pro plan’s seat limit. The Members card shows your current seat usage.
Managing Team Members
Section titled “Managing Team Members”Admins can manage existing team members from the Members section:
Change Role
Section titled “Change Role”- Promote members to admin to grant management permissions.
- Demote admins back to member to restrict permissions.
- Owners can additionally promote anyone to owner, or demote other owners, as long as at least one owner remains.
Remove User
Section titled “Remove User”- Revokes all access to the team.
- The user must be invited again to restore access.
- Users can leave a team themselves, except the last remaining owner, they must delete the team or promote someone else to owner first.
Deleting a Team
Section titled “Deleting a Team”Only an owner can permanently delete a team. Once deleted, all data and applications associated with the team will be lost, and any active Pro subscription is cancelled.
You cannot delete your only remaining team. If you want to fully remove it, delete your account from your user Settings instead.
To delete a team:
- Go to Settings.
- Scroll to the Delete Team section.
- Click Delete Team.
- In the confirmation dialog, type
delete team <team-slug>to confirm. - Click Delete Team to permanently remove the team.