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

# Organization & studio permissions

> Who can do what across organizations, studios, and learner accounts in Real Talk Studio

This guide explains access levels for **organizations** and **studios**. Share it with client admins, L\&D leads, and IT stakeholders when onboarding a new account.

## How the hierarchy works

Real Talk Studio uses two nested layers:

```
Organization
├── Team (org admins & org members)
├── Organization credits
├── Catalog (roleplays, presentations, personas)
└── Studios
    ├── Studio admins
    ├── Studio members (learners)
    ├── Studio credits
    └── Learning content assigned to the studio
```

* An **organization** is the top-level account for a company or programme (e.g. “Acme Hospitality Group”).
* **Studios** are learning spaces inside an organization — typically one per team, region, or cohort (e.g. “Front Desk Training”, “London Managers”).
* **Studio members** are the people who *practice* roleplays. They are separate from **organization team** users, who *manage* the account.

<Note>
  A studio can also exist **without** an organization (individual trainer accounts). In that case, the studio owner has admin access directly and there is no organization-level credit pool.
</Note>

***

## Organization roles

| Capability                                                            | Super Admin | Admin | Member |
| --------------------------------------------------------------------- | :---------: | :---: | :----: |
| View organization overview, stats, and analytics                      |      ✓      |   ✓   |    ✓   |
| View organization catalog (roleplays & presentations)                 |      ✓      |   ✓   |    ✓   |
| View and manage organization personas                                 |      ✓      |   ✓   |    —   |
| View credit ledger and transaction history                            |      ✓      |   ✓   |    —   |
| Update organization profile (name, logo, description)                 |      ✓      |   ✓   |    —   |
| Create studios linked to the organization                             |      ✓      |   ✓   |    —   |
| Manage all studios in the organization (inherits studio admin access) |      ✓      |   ✓   |    —   |
| Add / remove organization team members                                |      ✓      |   ✓   |    —   |
| Create and edit organization-owned roleplays & presentations          |      ✓      |   ✓   |    —   |
| Allocate credits from organization pool → studios                     |      ✓      |   ✓   |    —   |
| Use organization credits for own practice sessions                    |      ✓      |   ✓   |    —   |
| Manage SSO access grants (when SSO is enabled)                        |      ✓      |   ✓   |    —   |

### Super Admin

* Automatically assigned to the user who **creates** the organization.
* Has full administrative control over the organization and all of its studios.
* Displayed with a distinct badge in **Organization → Team**. There is no separate “super admin only” feature set — the role identifies the founding account.

### Admin

* Added by an existing org admin from **Organization → Team → Add Admin**.
* Can manage studios, members, content, credits, and other org admins (except removing the last admin).
* Receives a **trainer** account type so they can build and run roleplays.

### Member

* Added from the same Team screen with role **Member — Can view organization**.
* Intended for stakeholders who need visibility into the org (reporting, oversight) without day-to-day admin duties.
* Does **not** receive trainer/builder capabilities at the organization level.

<Info>
  **Organization Member** (team role) is different from **Studio Member** (learner). Organization members manage or observe the account; studio members practise scenarios.
</Info>

***

## Studio roles

Each studio has two practical roles. A user can be a studio admin through **direct assignment** or by being an **organization admin** — org admins automatically inherit admin access to every studio in their organization.

| Capability                                                            | Studio Admin | Studio Member (learner) |
| --------------------------------------------------------------------- | :----------: | :---------------------: |
| Access studio admin dashboard                                         |       ✓      |            —            |
| View studio analytics & session history                               |       ✓      |            —            |
| Add, deactivate, and manage studio members                            |       ✓      |            —            |
| Assign members to cohorts                                             |       ✓      |            —            |
| Allocate studio credits → individual members                          |       ✓      |            —            |
| Approve access requests (private studios)                             |       ✓      |            —            |
| Add roleplays / presentations from org catalog                        |       ✓      |            —            |
| Reorder, feature, embed, and share studio content                     |       ✓      |            —            |
| Generate single-use and share links                                   |       ✓      |            —            |
| Configure studio settings (privacy, leaderboard, confidence tracking) |       ✓      |            —            |
| Allocate org credits → studio (org-linked studios only)               |      ✓\*     |            —            |
| Access studio catalog / learning path                                 |       ✓      |            ✓            |
| Run assigned roleplays and presentations                              |       ✓      |            ✓            |
| Create personal custom roleplays (visible only to self)               |       ✓      |            ✓            |
| View own completion history & feedback                                |       ✓      |            ✓            |
| Request access to a private studio                                    |       —      |            ✓            |

\* Moving credits from the organization pool to a studio requires organization admin privileges. Studio-only admins on non-org studios manage credits differently.

### How studio admin access is granted

1. **Direct studio admin** — assigned when creating the studio or by an existing admin (typical for team leads).
2. **Organization admin inheritance** — any organization admin can manage every studio in that organization without a separate studio admin assignment.

### Studio member (learner) behaviour

* Added by a studio admin (individually or in bulk, with optional welcome emails).
* For **private** studios, must be an active member to view the catalog; non-members can **request access** and wait for admin approval.
* For **public** studios, the catalog may be browsable without membership, depending on configuration.
* Practice sessions consume **member credits** (allocated by admins from the studio pool), unless the roleplay is marked free.
* **Organization admins** running sessions in a studio use the **organization credit pool** instead of member credits.

### Custom vs organization content in a studio

When a studio member opens the catalog:

| Content type                                    | Who sees it        | Where it appears   |
| ----------------------------------------------- | ------------------ | ------------------ |
| Roleplays created by org admins                 | All studio members | Main learning path |
| System / shared roleplays (no individual owner) | All studio members | Main learning path |
| Roleplays created by a studio member            | Only that member   | “Custom” section   |

The same pattern applies to presentations linked to the studio.

***

## Credits flow

Credits move down the hierarchy:

```
Organization credit pool
        ↓  (org admin allocates)
Studio credit pool
        ↓  (studio admin allocates)
Individual member credits
        ↓  (deducted on practice)
Roleplay session
```

| Action                                           | Who can do it                                                       |
| ------------------------------------------------ | ------------------------------------------------------------------- |
| Purchase / deposit credits at organization level | Real Talk Studio ops / billing (not self-serve in app)              |
| View org ledger                                  | Organization admins                                                 |
| Move credits org → studio                        | Organization admins                                                 |
| Move credits studio → org (return unused)        | Organization admins                                                 |
| Move credits studio → member                     | Studio admins (org admins also qualify)                             |
| Remove credits from a member (return to studio)  | Studio admins                                                       |
| Spend credits on a practice session              | Studio members (from member balance); org admins (from org balance) |

All movements are recorded in the **Ledger** (organization view) and in studio-level transaction history.

***

## SSO access grants (optional)

When SSO is configured for an organization, admins can create **access grants** from **Organization → Team → SSO Access Grants**.

| Field           | Purpose                                            |
| --------------- | -------------------------------------------------- |
| Email           | User who receives access when they sign in via SSO |
| Initial credits | Credits assigned on first login                    |
| Studios         | Which studios the user is automatically added to   |
| Expiry          | Optional expiration date                           |

This automates studio onboarding for enterprise SSO users without manual member invites.

***

## Standalone studios (no organization)

Trainers can create a studio that is **not** linked to an organization:

| Role                 | Capabilities                                                                                     |
| -------------------- | ------------------------------------------------------------------------------------------------ |
| Studio owner / admin | Full studio admin capabilities listed above; no org catalog, ledger, or org → studio credit flow |
| Studio member        | Same learner experience as org-linked studios                                                    |

Organization features (multi-studio management, org catalog, personas library, org ledger) require an organization.

***

## Who should I invite as what?

| Person                                  | Recommended role                                    |
| --------------------------------------- | --------------------------------------------------- |
| Programme owner / client sponsor        | Organization **Super Admin** or **Admin**           |
| L\&D manager building content           | Organization **Admin**                              |
| Finance / reporting contact (view only) | Organization **Member**                             |
| Team lead managing one cohort           | Organization **Admin** *or* direct **Studio Admin** |
| Frontline staff practising scenarios    | **Studio Member** (learner) — not an org team user  |

***

## Related pages in the app

These paths are on [app.realtalkstudio.com](https://app.realtalkstudio.com):

| Area                   | Path                                    |
| ---------------------- | --------------------------------------- |
| Organization list      | `/organizations`                        |
| Organization overview  | `/organizations/{orgId}`                |
| Team & SSO grants      | `/organizations/{orgId}/team`           |
| Org catalog            | `/organizations/{orgId}/catalog`        |
| Org personas           | `/organizations/{orgId}/personas`       |
| Org credit ledger      | `/organizations/{orgId}/ledger`         |
| Studio admin dashboard | `/admin/studios/{studioSlug}`           |
| Studio members         | `/admin/studios/{studioSlug}/members`   |
| Studio analytics       | `/admin/studios/{studioSlug}/analytics` |
| Learner catalog        | `/studio/{studioSlug}`                  |