# Invite members and set roles

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

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

| Role | What it can do |
| --- | --- |
| **Owner** | Everything, including owner-only actions such as deleting the team. |
| **Admin** | Manage members, billing, credentials and project settings. |
| **Member** | Use 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](https://docs.polymorfa.com/development/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](https://docs.polymorfa.com/teams/account-security#delete-your-account).

## List members through the API

`GET /platform/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](https://docs.polymorfa.com/api/members/list-members).

## See also

- [Manage teams and projects](https://docs.polymorfa.com/teams)
- [Choose notifications](https://docs.polymorfa.com/teams/notifications)
- [Review audit history](https://docs.polymorfa.com/teams/audit-history)
