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

# Teams

> Teammitglieder und Einladungen in deinem Workspace einladen und verwalten

Mit den Team-Befehlen lädst du Mitglieder in deinen Workspace ein, listest aktuelle Mitglieder und ausstehende Einladungen auf, änderst Rolle und Beitragsfreigabe-Einstellung eines Mitglieds, entfernst Mitglieder und widerrufst Einladungen.

> [!NOTE]
>
> Alle Befehle akzeptieren die [globalen Flags](/de/cli/overview.md#globale-optionen): `--json` (Standard) / `--table`, `--verbose`, `--api-key <key>` und `--api-url <url>`. Du kannst dich auch über die Umgebungsvariablen `SOME_API_KEY` und `SOME_API_URL` authentifizieren.

> [!NOTE]
>
> **Rollen** sind `member` oder `owner`. Die **Beitragsfreigabe** ist `requires_approval` oder `auto_approve` und legt fest, ob die Beiträge des Mitglieds vor der Veröffentlichung freigegeben werden müssen.

## teams:list

Listet die Mitglieder deines Workspace auf.

```bash theme={null}
so-me teams:list [options]
```

| Option | Beschreibung | Standard |
| - | - | - |
| `--page <number>` | Seitennummer | `1` |
| `--limit <number>` | Einträge pro Seite | `50` |

```bash Beispiele theme={null}
# Standard-JSON-Ausgabe
so-me teams:list

# Tabellenansicht
so-me teams:list --table

# Paginieren
so-me teams:list --page 2 --limit 100

# Nur Inhaber per jq auflisten
so-me teams:list --limit 100 | jq '.data[] | select(.role == "owner")'
```

## teams:invite

Lädt ein neues Teammitglied per E-Mail ein.

```bash theme={null}
so-me teams:invite --email <email> [options]
```

| Option | Beschreibung | Standard |
| - | - | - |
| `--email <email>` | Einzuladende E-Mail-Adresse **(erforderlich)** | — |
| `--role <role>` | Rolle des Mitglieds: `member` oder `owner` | `member` |
| `--post-approval <approval>` | Beitragsfreigabe: `requires_approval` oder `auto_approve` | Server-Standard |

> [!NOTE]
>
> Der Wert von `--role` wird gegen `member` / `owner` validiert und vor dem Senden in Kleinbuchstaben umgewandelt. Fehlt `--post-approval`, wendet das Backend seine Standard-Freigabeeinstellung an.

```bash Beispiele theme={null}
# Mit Standardeinstellungen einladen (Rolle member)
so-me teams:invite --email alice@example.com

# Einen Inhaber einladen
so-me teams:invite --email bob@example.com --role owner

# Ein Mitglied einladen, das ohne Freigabe veröffentlichen darf
so-me teams:invite --email carol@example.com --role member --post-approval auto_approve

# Ein Mitglied einladen, dessen Beiträge freigegeben werden müssen
so-me teams:invite --email dan@example.com --post-approval requires_approval
```

## teams:invitations

Listet ausstehende Team-Einladungen auf.

```bash theme={null}
so-me teams:invitations [options]
```

| Option | Beschreibung | Standard |
| - | - | - |
| `--page <number>` | Seitennummer | `1` |
| `--limit <number>` | Einträge pro Seite | `50` |

```bash Beispiele theme={null}
# Standard-JSON-Ausgabe
so-me teams:invitations

# Tabellenansicht
so-me teams:invitations --table

# Paginieren
so-me teams:invitations --page 2 --limit 100
```

## teams:update

Aktualisiert Rolle und/oder Beitragsfreigabe-Einstellung eines Teammitglieds. Du musst `--role`, `--post-approval` oder beides angeben — der Befehl schlägt fehl, wenn nichts davon angegeben ist.

```bash theme={null}
so-me teams:update <id-or-email> [options]
```

**id-or-email** `string` *required*

ID oder E-Mail-Adresse des Mitglieds.

| Option | Beschreibung |
| - | - |
| `--role <role>` | Rolle des Mitglieds: `owner` oder `member` |
| `--post-approval <approval>` | Beitragsfreigabe: `requires_approval` oder `auto_approve` |

> [!NOTE]
>
> Wenn du nur `--post-approval` änderst (ohne `--role`), sucht die CLI das Mitglied zuerst in deiner Teamliste, um dessen bestehende Rolle beizubehalten, da der zugrunde liegende Endpunkt immer eine Rolle verlangt. Die Werte von `--role` und `--post-approval` werden vor dem Senden der Anfrage validiert.

```bash Beispiele theme={null}
# Ein Mitglied zum Inhaber befördern
so-me teams:update alice@example.com --role owner

# Ein Mitglied auf automatische Freigabe umstellen (Rolle bleibt automatisch erhalten)
so-me teams:update alice@example.com --post-approval auto_approve

# Rolle und Beitragsfreigabe gemeinsam aktualisieren
so-me teams:update bob@example.com --role member --post-approval requires_approval

# Per Mitglieds-ID aktualisieren
so-me teams:update 550e8400-e29b-41d4-a716-446655440000 --role owner
```

## teams:remove

Entfernt ein Teammitglied aus dem Workspace. Du wirst um Bestätigung gebeten, sofern du nicht `-y, --yes` angibst.

```bash theme={null}
so-me teams:remove <id-or-email> [options]
```

**id-or-email** `string` *required*

ID oder E-Mail-Adresse des Mitglieds.

| Option | Beschreibung |
| - | - |
| `-y, --yes` | Bestätigungsabfrage überspringen |

```bash Beispiele theme={null}
# Ein Mitglied entfernen (fragt nach Bestätigung)
so-me teams:remove alice@example.com

# Ohne Bestätigung entfernen
so-me teams:remove alice@example.com -y

# Per Mitglieds-ID entfernen
so-me teams:remove 550e8400-e29b-41d4-a716-446655440000 --yes
```

## teams:cancel-invite

Widerruft eine ausstehende Einladung per ID oder E-Mail-Adresse. Du wirst um Bestätigung gebeten, sofern du nicht `-y, --yes` angibst.

```bash theme={null}
so-me teams:cancel-invite <id-or-email> [options]
```

**id-or-email** `string` *required*

ID oder E-Mail-Adresse der Einladung.

| Option | Beschreibung |
| - | - |
| `-y, --yes` | Bestätigungsabfrage überspringen |

```bash Beispiele theme={null}
# Eine Einladung widerrufen (fragt nach Bestätigung)
so-me teams:cancel-invite alice@example.com

# Ohne Bestätigung widerrufen
so-me teams:cancel-invite alice@example.com -y

# Alle ausstehenden Einladungen in einer Pipeline widerrufen
so-me teams:invitations --limit 100 \
  | jq -r '.data[].id' \
  | xargs -I {} so-me teams:cancel-invite {} -y
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.