Skip to content
Shortcut: /, ⌘K or Ctrl+K

Invite members and set roles

Invite people to your team, choose their role, and remove members or leave a team.

View as Markdown

Invite people to your team by email and give each one a role. Every team, Free or Pay-As-You-Go, can have any number of members. Access follows the current membership, so a role change or removal applies to the member's next request.

Before you begin#

  • You need the owner or admin role to invite, change roles and remove members.
  • People join with their own Polymorfa account. They can accept an invitation without owning a team.

Roles#

RoleWhat it can do
OwnerEverything, including owner-only actions such as deleting the team.
AdminManage members, billing, credentials and project settings.
MemberUse the team's projects. Read settings that need a higher role to change.

Invitations assign Admin or Member. Ownership is never given through an invitation, and the role menu offers only Make admin and Make member.

Invite members#

  1. Open Team settings > Members and select Invite members.
  2. Enter an email and choose a Role. Select Add another to invite several people at once.
  3. Select Send invitations.

Each person receives an invitation email. Pending invitations appear on the Invitations tab. To withdraw one, open its menu, select Revoke invitation and confirm. To send an invitation again, revoke it and invite the person again.

Accept an invitation#

  1. Open Account > Invites. The page lists pending invitations sent to your verified email addresses.
  2. Select Accept to join, or Decline to remove the invitation.

Accepting refreshes your access and opens the team. If an invitation expired or no longer appears, ask a team owner or admin to send another. If your session expires while the page is open, sign in again and the Console returns you to Invites.

Change a member's role#

  1. Open Team settings > Members.
  2. Find the member. Search by name or email, or filter by role.
  3. Open the member's menu and select Make admin or Make member.

The member receives a notice that their role changed.

Remove members#

  1. Open Team settings > Members.
  2. Open the member's menu, select Remove from team and confirm.

Owners cannot be removed this way; their menu shows Owners can't be removed here. A removed member loses access to the team and its projects at once. API keys that belong to that person are revoked; keys created as a service account keep working. See API keys.

Leave a team#

  1. Open Account > Overview, which lists your teams.
  2. Open the team's menu and select Leave team, then confirm. You can also select Leave team in Team settings > General.

You lose access to the team and all its projects immediately; the team and its data stay. If you are the team's only owner, another owner must exist before you can leave.

Your final team can only be removed by deleting your personal account. See Delete your account.

List members through the API#

API List members lists the team's members. It needs a team key with sessions:read; project tokens are not accepted. Inviting, changing roles and removing members happen in the Console. See List members.

See also#