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

# Team Management

> Manage members, roles, and invitations in the Web Console.

## Overview

The Team page lets you manage your organization's members and their access levels. Invite new members, assign roles, and configure tenant settings.

## Roles

Refrain uses a 4-level role hierarchy:

| Role          | Description                                                                                        |
| ------------- | -------------------------------------------------------------------------------------------------- |
| **Owner**     | Full access. Manage billing, tenant settings, and delete the tenant. Only one owner per tenant.    |
| **Admin**     | Manage team members, settings, and runbook publishing. Cannot manage billing or delete the tenant. |
| **Developer** | Create and edit runbooks, run jobs. Cannot manage settings or team.                                |
| **Member**    | View runbooks and jobs. Can run jobs but cannot create or edit runbooks.                           |

### Permission matrix

| Action                   | Owner | Admin | Developer | Member |
| ------------------------ | :---: | :---: | :-------: | :----: |
| Manage billing           |   ✓   |   -   |     -     |    -   |
| Delete tenant            |   ✓   |   -   |     -     |    -   |
| Invite members           |   ✓   |   ✓   |     -     |    -   |
| Remove members           |   ✓   |   ✓   |     -     |    -   |
| Change roles             |   ✓   |   ✓   |     -     |    -   |
| Configure settings       |   ✓   |   ✓   |     -     |    -   |
| Publish/disable runbooks |   ✓   |   ✓   |     -     |    -   |
| Create/edit runbooks     |   ✓   |   ✓   |     ✓     |    -   |
| Run jobs                 |   ✓   |   ✓   |     ✓     |    ✓   |
| View runbooks/jobs       |   ✓   |   ✓   |     ✓     |    ✓   |

## Inviting members

<Steps>
  <Step title="Go to Team settings">
    Navigate to **Settings > Team**.
  </Step>

  <Step title="Click Invite">
    Click the **Invite Member** button.
  </Step>

  <Step title="Enter details">
    Enter the email address and select a role.
  </Step>

  <Step title="Send invitation">
    The invited user receives an email with a link. Invitations expire after 7 days.
  </Step>
</Steps>

## Managing invitations

| Action     | Description                     |
| ---------- | ------------------------------- |
| **Resend** | Send the invitation email again |
| **Cancel** | Revoke a pending invitation     |

## Tenant settings

From the Team page, Admins and Owners can also configure:

| Setting         | Description                                     |
| --------------- | ----------------------------------------------- |
| **Tenant name** | Display name for the organization               |
| **Slug**        | URL identifier (lowercase, hyphens, 3-48 chars) |
| **Language**    | Default language for the tenant (`en` or `ja`)  |
