> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moda.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Members and roles

> Invite teammates to your workspace and control what each role can do.

Manage workspace access at **Settings → Members & roles**. Moda accounts are provisioned by the Moda team — there is no self-serve signup — and teammates join an existing workspace through invitations.

## Roles

Every member has one of three roles:

| Role   | Summary                                                                                                     |
| ------ | ----------------------------------------------------------------------------------------------------------- |
| Viewer | Read-only access to the dashboard. The default role for invitations.                                        |
| Admin  | Everything a viewer can do, plus workspace management: keys, members, integrations, and workspace settings. |
| Owner  | Everything an admin can do, plus promoting members to admin and transferring ownership.                     |

What each action requires:

| Action                                                          | Viewer | Admin | Owner |
| --------------------------------------------------------------- | ------ | ----- | ----- |
| View conversations, signals, problems, and other dashboard data | Yes    | Yes   | Yes   |
| View the ingestion-key list                                     | Yes    | Yes   | Yes   |
| Create and revoke ingestion keys                                | —      | Yes   | Yes   |
| Invite members and cancel pending invitations                   | —      | Yes   | Yes   |
| Change a member's role to Viewer                                | —      | Yes   | Yes   |
| Promote a member to Admin                                       | —      | —     | Yes   |
| Remove a member                                                 | —      | Yes   | Yes   |
| Rename the workspace                                            | —      | Yes   | Yes   |
| Manage the GitHub integration and re-run harness analysis       | —      | Yes   | Yes   |
| Correct a harness capture                                       | —      | Yes   | Yes   |
| Adjust the CLI key limit                                        | —      | Yes   | Yes   |
| Transfer ownership                                              | —      | —     | Yes   |

The owner's role cannot be changed and the owner cannot be removed; ownership moves only through a transfer.

## Inviting a member

<Steps>
  <Step title="Open the invite dialog">
    In **Settings → Members & roles**, click **Invite member**. Requires the admin or owner role.
  </Step>

  <Step title="Enter the email and role">
    Choose **Viewer** (read-only access, the default) or **Admin** (can manage settings and invite members). Invitations cannot grant the Owner role.
  </Step>

  <Step title="Send and track">
    The invitation appears under pending invitations, where it can be cancelled. It expires after 7 days.
  </Step>

  <Step title="The invitee accepts">
    The invitee opens the invitation link, accepts, and lands in the workspace with the assigned role.
  </Step>
</Steps>

<Note>
  Invitations are for email addresses that do not yet have a Moda account. Inviting an existing account is rejected with "This user already has an account. Existing users cannot be invited - they must be added directly."
</Note>

## Changing roles and removing members

Admins and owners manage membership from the member list:

* Change any non-owner member's role. Only the owner can promote a member to Admin; admins can set members to Viewer.
* Remove any non-owner member. You cannot change your own role or remove yourself.

## Transferring ownership

Only the owner can transfer ownership. In the member list, set another member's role to **Owner**; a confirmation dialog completes the transfer. After the transfer, the previous owner becomes an Admin and can no longer transfer ownership.

## Next steps

* [Authentication](/administration/authentication) — the key management actions these roles gate.
* [Limits](/administration/limits) — the CLI key limit admins can adjust.
* [Quickstart](/quickstart) — get data flowing once your team has access.