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

# FAQ

> Antworten auf häufige Fragen zu SquadVault-Konten, Organisationen, Discord, Feedback, Flows, Abrechnung und der API.

## Konto und Zugang

<AccordionGroup>
  <Accordion title="Wie komme ich zu SquadVault?">
    SquadVault ist in einer Public Beta. Erstelle ein Konto auf [squadvault.xyz](https://squadvault.xyz) oder schreibe an [hello@squadvault.xyz](mailto:hello@squadvault.xyz).
  </Accordion>

  <Accordion title="Ich wurde eingeladen, sehe die Organisation aber nicht.">
    Akzeptiere den Einladungslink, während du mit der eingeladenen E-Mail-Adresse angemeldet bist. Nutze danach den Organisations-Umschalter in der Seitenleiste.
  </Accordion>

  <Accordion title="Kann ich einen Passkey verwenden?">
    Ja. Passkeys kannst du unter **Einstellungen → Konto** hinzufügen und verwalten.
  </Accordion>

  <Accordion title="Wie funktioniert die Zwei-Faktor-Authentifizierung (2FA)?">
    Aktiviere 2FA unter **Einstellungen → Konto**. Sie schützt die Anmeldung mit **E-Mail und Passwort** über einen Authenticator-Code. Discord- und Passkey-Logins nutzen eigene Faktoren und werden standardmäßig nicht mit TOTP abgefragt. Owner und Admins sollten 2FA aktivieren.
  </Accordion>

  <Accordion title="Wie verwalte ich Geräte und verbundene Konten?">
    Unter **Einstellungen → Konto** siehst du aktive Sitzungen, kannst andere Geräte abmelden und verbundene E-Mail-, Discord- und Passkey-Methoden prüfen. Behalte mindestens eine Anmeldemethode.
  </Accordion>
</AccordionGroup>

## Organisationen und Berechtigungen

<AccordionGroup>
  <Accordion title="Was ist der Unterschied zwischen den Rollen?">
    Inhaber und Admins verwalten die Organisation (Mitglieder, Abrechnung, Discord, API-Keys). Manager betreuen Roster, Kalender, Dokumente, Aufgaben und Tryouts organisationsweit. Coaches verwalten Termine und Aufgaben in ihren zugewiesenen Teams. Mitglieder nehmen teil und pflegen ihre eigene Verfügbarkeit. Betrachter haben nur Lesezugriff. Siehe [Organisationen](/de/user-guide/organizations).
  </Accordion>

  <Accordion title="Warum erhalte ich einen Berechtigungsfehler?">
    Deiner Rolle fehlt möglicherweise die Berechtigung für die Aktion, oder die Funktion ist in deinem Tarif gesperrt. Bitte einen Inhaber oder Admin, deine Rolle anzupassen oder den Tarif zu erweitern.
  </Accordion>

  <Accordion title="Kann ich mehreren Organisationen angehören?">
    Ja. Wechsle über den Organisations-Umschalter in der Seitenleiste zwischen ihnen.
  </Accordion>

  <Accordion title="Wie exportiere oder lösche ich Organisationsdaten?">
    Inhaber öffnen **Einstellungen → Organisation → Daten und Inhaberschaft**. Dort gibt es den JSON-Download, den Inhaber-Transfer und das Löschen der Organisation. Persönlicher Account-Export und Kontolöschung bleiben unter **Einstellungen → Konto**.
  </Accordion>
</AccordionGroup>

## Discord

<AccordionGroup>
  <Accordion title="Wer kann Discord verbinden?">
    Organisations-Admins, sofern Discord Sync in deinem Tarif enthalten ist.
  </Accordion>

  <Accordion title="Die Synchronisierung hat die Rollen nicht aktualisiert.">
    Prüfe, ob der Server verbunden ist, die Rollen-Zuordnungen stimmen und der Bot in Discord noch die nötigen Rechte hat. Versuche einen Testlauf und dann eine vollständige Synchronisierung.
  </Accordion>
</AccordionGroup>

## Scrims

<AccordionGroup>
  <Accordion title="Ist SquadVault ein Scrim-Finder?">
    Nein. SquadVault ist Mission Control **nach** dem Booking. Importiere von Gankster oder plane manuell, dann bereite das Team vor. Siehe [Scrims](/de/user-guide/scrims).
  </Accordion>

  <Accordion title="Warum öffnet ein Kalender-Scrim einen Workspace?">
    Scrim-Termine öffnen Mission Control statt des normalen Edit-Dialogs — Prep, Verfügbarkeit und Ergebnisse liegen dort.
  </Accordion>
</AccordionGroup>

## Feedback

<AccordionGroup>
  <Accordion title="Wer kann Umfragen erstellen?">
    Staff mit Feedback-Create-Recht, wenn Feedback-Umfragen im Tarif enthalten sind. Mitglieder antworten in der Regel nur. Siehe [Feedback](/de/user-guide/feedback).
  </Accordion>

  <Accordion title="Können Umfragen ohne SquadVault-Konto ausgefüllt werden?">
    Ja, wenn der Zugang **Öffentlich** ist und die Umfrage offen ist. Teile den öffentlichen Link aus dem Builder. Titelbilder brauchen das Feature für eigenes Umfrage-Branding.
  </Accordion>
</AccordionGroup>

## Flows

<AccordionGroup>
  <Accordion title="Mein Workflow ist nicht gelaufen.">
    Prüfe, ob er **aktiv** ist (kein Entwurf) und der Trigger zu deiner Aktion passt, und schau unter **Flows → Aktivität** nach Fehlern. Siehe [Flows](/de/user-guide/flows).
  </Accordion>

  <Accordion title="Wie pinge ich ein ganzes Team in Discord?">
    Füge **Get team players** hinzu und nutze dann `{{steps.N.discordMentions}}` in einer Discord-Nachricht. Details in der [Flows-Referenz](/de/user-guide/flows-reference).
  </Accordion>
</AccordionGroup>

## Abrechnung

<AccordionGroup>
  <Accordion title="Wer kann den Tarif ändern?">
    Nur Inhaber und Admins der Organisation.
  </Accordion>

  <Accordion title="Ich habe upgegradet, eine Funktion ist aber noch gesperrt.">
    Lade die App nach kurzer Wartezeit neu. Bleibt sie gesperrt, prüfe im Abrechnungsportal das Abonnement oder wende dich an den Support.
  </Accordion>
</AccordionGroup>

## API-Keys

<AccordionGroup>
  <Accordion title="Wo erstelle ich einen API-Key?">
    Unter **Integrationen → API-Keys** (API-Feature muss im Tarif enthalten sein). Siehe [Authentifizierung](/de/api/authentication) und [Integrationen](/de/user-guide/integrations).
  </Accordion>

  <Accordion title="Welchen Header muss ich senden?">
    Sende bei jeder Anfrage an `https://api.squadvault.xyz/v1` den Header `x-api-key: YOUR_API_KEY`. Organisations-Keys benötigen keinen internen Gateway-Key.
  </Accordion>

  <Accordion title="Warum erhalte ich 403 mit einem gültigen Key?">
    Der Key ist gültig, ihm fehlt aber eine Berechtigung für diese Aktion, oder er gehört zu einer anderen Organisation. Prüfe die Key-Berechtigungen und die Organisations-ID im Pfad oder Body.
  </Accordion>
</AccordionGroup>

## Audit Log

<AccordionGroup>
  <Accordion title="Wo finde ich das Audit Log?">
    Unter **Administration → Audit Log** (Inhaber und Admins; Audit-Log-Feature erforderlich). Siehe [Audit Log](/de/user-guide/audit-log).
  </Accordion>

  <Accordion title="Warum fehlt ein erwartetes Event?">
    Nur Mutationen werden protokolliert. Prüfe Filter (Quelle, Ergebnis, Bereich, Suche) und nutze **Mehr laden**.
  </Accordion>
</AccordionGroup>

## Immer noch nicht weiter?

Schreibe an [hello@squadvault.xyz](mailto:hello@squadvault.xyz) mit dem Namen deiner Organisation, was du versucht hast und der Fehlermeldung oder Request-ID, die du siehst.