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

# Workspaces

> Workspaces wechseln, weitere erstellen und Profil sowie Team jedes Workspace verwalten

Ein **Workspace** trennt seine Assistenten, Anrufe, Kampagnen, Wissensdatenbanken, Telefonnummern, Plan, Credits und Abrechnung von anderen Workspaces. Bei der Registrierung wird der erste Workspace automatisch erstellt.

Du kannst außerdem anderen Workspaces beitreten und – wenn dein Plan es erlaubt – weitere eigene Workspaces anlegen.

## Workspace wechseln

Wähle oben in der Seitenleiste den Workspace-Avatar. Der Switcher zeigt alle Workspaces, auf die du zugreifen kannst, sowie deine Rolle in jedem Workspace. Nach der Auswahl lädt das Dashboard die Daten dieses Workspace.

Die Auswahl gilt nur für deine eigene Session. Andere Mitglieder behalten ihren aktuellen Workspace.

## Weiteren Workspace erstellen

Öffne den Workspace-Switcher und wähle **New workspace**. Der Dialog zeigt, ob dein Konto noch einen Workspace erstellen kann, und fragt nach einem Namen.

Die Zahl zusätzlicher Workspaces hängt von deinem Plan und dem Add-on **Extra Workspaces** ab – zusätzliche Kapazität, die du pro weiterem Workspace unter **Settings → Plan** hinzubuchst, genau wie bei den anderen Kapazitäts-Add-ons. Die Mitgliedschaft in einem fremden Workspace verbraucht dein Erstellkontingent nicht. Bestehende Workspaces bleiben erreichbar, wenn sich dein Kontingent später ändert; das Limit gilt beim Erstellen.

Jeder neue Workspace startet getrennt. Prüfe deshalb Plan und Abrechnung, bevor du produktive Ressourcen hinzufügst.

## Workspace-Profil

Öffne **Settings → Workspace**, um Identität und Standardwerte des aktiven Workspace anzusehen und zu bearbeiten: Logo, Name, Unternehmens-Website, Zeitzone, Datumsformat und die Standardsprache für Mitglieder, die selbst noch keine gewählt haben. Owner und Admins können diese Felder ändern; jede andere Rolle sieht dieselben Felder nur lesend. Die Seite zeigt außerdem die Workspace-ID – nur lesend, und der Wert, den du in [Support-Anfragen](/de/support) und API-Aufrufen angibst.

**AI inference region** legt fest, wo Famulor die KI-Verarbeitung hinter diesem Workspace ausführt – die Sprachmodell-Arbeit in Gesprächen und den KI-Judge, der sie im Anschluss auswertet. Bei **Global** wählt Famulors eigenes Routing; pinnst du **EU** oder **US**, bleibt diese Verarbeitung in der gewählten Zone, und der Modellkatalog schrumpft auf das dort verfügbare Angebot, sodass ein Assistent nur auf ein in dieser Region verfügbares Modell eingestellt werden kann. Das ist die Steuerung auf Workspace-Ebene hinter den in [Trust Center](/de/support/trust-center) beschriebenen Zusagen zum Verarbeitungsort. Das Pinnen einer Region kann die Kosten dieser KI-Nutzung gegenüber Global-Routing erhöhen.

Auf dieser Seite liegt auch der Schalter **Beta features**. Mehrere Funktionen, auf die diese Dokumentation an anderer Stelle verweist – unter anderem connected-app-Trigger in [Automatisierungen](/de/automations/overview), [WhatsApp Call](/de/telephony/whatsapp-voice) und die Beta-Kanal-Connectors – bleiben verborgen, bis ein Owner oder Admin sie aktiviert. Beta-Funktionen können instabil sein und sich ändern, und manche verarbeiten zusätzlichen Gesprächskontext und erzeugen zusätzliche KI-Nutzung – prüfe daher jede einzelne, bevor du sie aktivierst.

## Rollen und Teamverwaltung

Öffne **Settings → Workspace → Team** in dem Workspace, in dem die Person arbeiten soll. Einladungen und Rollen gelten nur für diesen Workspace, und eine Person kann in jedem Workspace, dem sie angehört, eine andere Rolle haben – Owner im einen, Mitglied oder Betrachter im anderen. Das Team-Panel zeigt immer den Namen des aktiven Workspace, damit niemand versehentlich im falschen Konto eingeladen wird.

### Rollen

| Rolle       | Zugriff                                                                                                                                                                                                                          |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**   | Vollzugriff, einschließlich Team, Abrechnung und Workspace-Einstellungen. Das Konto, das den Workspace erstellt hat, trägt diese Rolle; sie kann im Team-Panel nicht an jemand anderen übergeben, geändert oder entfernt werden. |
| **Admin**   | Vollzugriff, einschließlich Team, Abrechnung und Workspace-Einstellungen.                                                                                                                                                        |
| **Member**  | Vollzugriff auf die ihm zugewiesenen Workspace-Funktionen.                                                                                                                                                                       |
| **Viewer**  | Nur lesend – kann keine Änderungen vornehmen.                                                                                                                                                                                    |
| **Billing** | Nur lesend, plus Verwaltung von Plan und Guthaben. Die Seitenleiste schrumpft auf Dashboard, Usage und eine auf Preferences, Plan und Balance reduzierte Settings-Seite.                                                         |

### Ein Mitglied einladen

Owner und Admins fügen ein Mitglied auf zwei Wegen hinzu:

* **Invite by email** – sendet eine E-Mail mit einem Link zum Setzen eines Passworts. Ein bereits bestehendes Konto wird direkt hinzugefügt und per E-Mail benachrichtigt, statt einen Einladungslink zu erhalten.
* **Create with a password** – lege selbst einen Namen und ein Startpasswort (mindestens 8 Zeichen) fest, ganz ohne E-Mail-Umweg.

Beide Wege fragen vorab die Rolle des neuen Mitglieds ab – jede Rolle außer Owner – und zeigen deren Beschreibung, während du auswählst. Ein per E-Mail hinzugefügtes Mitglied trägt in der Liste das Badge **Invited**, bis es sich zum ersten Mal anmeldet. Erreicht ein Workspace sein Mitgliederlimit, wird **Invite member** durch einen Link zu **Settings → Plan** für mehr Kapazität ersetzt.

### Ein Mitglied verwalten

Aus der Zeile eines Mitglieds können Owner und Admins:

* **Change their role** – eine neue Rolle aus dem Dropdown wählen; sie gilt sofort.
* **Send a login link** – verschickt per E-Mail einen einmal gültigen Link, der das Mitglied ohne Passwort anmeldet und kurz danach abläuft – praktisch, wenn jemand ausgesperrt ist.
* **Remove them** – entzieht nur den Zugriff auf diesen Workspace, ohne andere Workspaces zu berühren, denen die Person angehört, und lässt das Famulor-Konto selbst unangetastet.

Die Zeile des Owners trägt keines dieser Bedienelemente; bei jedem anderen Mitglied lässt sich die Rolle ändern oder das Mitglied entfernen.

## REST-API

Workspaces des Credentials auflisten:

```bash theme={null}
curl https://YOUR_DOMAIN/api/v1/workspaces \
  -H "Authorization: Bearer fam_..."
```

Workspace mit einem nutzerautorisierten Credential erstellen:

```bash theme={null}
curl -X POST https://YOUR_DOMAIN/api/v1/workspaces \
  -H "Authorization: Bearer fam_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Corp — EU"}'
```

Zum Auflisten wird `settings:read`, zum Erstellen `settings:write` benötigt. Ein reines Workspace-Service-Credential kann seinen eigenen Workspace auflisten, aber keinen Workspace im Namen einer Person erstellen.

Einen eigenen API-Key für einen Workspace aus der Liste erstellen:

```bash theme={null}
curl -X POST https://YOUR_DOMAIN/api/v1/workspaces/WORKSPACE_ID/api-keys \
  -H "Authorization: Bearer fam_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name":"EU reporting",
    "scopes":["calls:read","leads:read"],
    "expires_in_days":90
  }'
```

Dafür ist ein nutzerautorisiertes Credential mit `settings:write` nötig. Sein Nutzer muss im ausgewählten Workspace aktuell Owner oder Admin sein, und der Workspace muss zur selben Brand wie das Credential gehören. Das funktioniert für normale Multi-Workspace-Konten und benötigt keinen White-Label-Zugang. Mitglieder, Betrachter, Billing-Nutzer und reine Workspace-Service-Credentials dürfen diesen Vorgang nicht ausführen.

Der neue Key ist dauerhaft an den ausgewählten Workspace gebunden. Seine Scopes dürfen die des aufrufenden Credentials nicht überschreiten, und bei einem bereits befristeten aufrufenden Credential darf der neue Key nicht länger gültig sein. Der Klartext-Key erscheint nur in der erfolgreichen Antwort; speichere ihn deshalb sofort und wiederhole einen erfolgreichen Request nicht automatisch. Ein frisch erstellter Workspace darf seinen Key schon vor der Planaktivierung erhalten, normale API-Aufrufe mit diesem Key bleiben aber planabhängig.

Workspace-Kapazität und das Add-on für zusätzliche Mitglieder haben getrennte Aufgaben: Die Workspace-Kapazität steuert das Erstellen weiterer Workspaces, die Mitglieder-Kapazität steuert Einladungen. Keines von beiden stellt eine zusätzliche Voraussetzung dar, sobald ein Nutzer im Ziel-Workspace bereits Owner oder Admin ist.

## MCP

* `list_workspaces` listet die für den verbundenen Nutzer sichtbaren Workspaces.
* `create_workspace` erstellt einen Workspace, wenn der verbundene Nutzer noch Kontingent hat.
* `create_workspace_api_key` erstellt einen eigenen Key für einen sichtbaren Workspace, in dem der verbundene Nutzer Owner oder Admin ist.

Diese Operationen folgen denselben Berechtigungen und Planregeln wie die REST-API. Das Einladen, Entfernen oder Ändern der Rolle eines Mitglieds hat keine Entsprechung in REST oder MCP – die Teamverwaltung ist ausschließlich über die Oberfläche möglich.