> ## 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

> Answers to common questions about SquadVault accounts, organizations, Discord, Feedback, Flows, billing, and the API.

## Account and access

<AccordionGroup>
  <Accordion title="How do I join SquadVault?">
    SquadVault is in public beta. Create an account at [squadvault.xyz](https://squadvault.xyz) or email [hello@squadvault.xyz](mailto:hello@squadvault.xyz).
  </Accordion>

  <Accordion title="I was invited but cannot see the organization.">
    Accept the invitation link while signed in with the invited email. Then use the organization switcher in the sidebar.
  </Accordion>

  <Accordion title="Can I use a passkey?">
    Yes. Add or manage passkeys under **Settings → Account**.
  </Accordion>

  <Accordion title="How does two-factor authentication (2FA) work?">
    Enable 2FA under **Settings → Account**. It protects **email and password** sign-in with an authenticator app code. Discord and passkey logins use their own factors and are not challenged for TOTP by default. Owners and admins should enable 2FA.
  </Accordion>

  <Accordion title="How do I manage devices and connected accounts?">
    Under **Settings → Account** you can review active sessions, sign out other devices, and see connected email, Discord, and passkeys. Keep at least one sign-in method linked.
  </Accordion>
</AccordionGroup>

## Organizations and permissions

<AccordionGroup>
  <Accordion title="What is the difference between roles?">
    Owners and admins manage the organization (members, billing, Discord, API keys). Managers run roster, calendar, documents, tasks, and tryouts org-wide. Coaches manage events and tasks on assigned teams. Members participate and update their own availability. Viewers are read-only. See [Organizations](/user-guide/organizations).
  </Accordion>

  <Accordion title="Why am I getting a permission error?">
    Your role may lack the action, or the feature may be locked on your plan. Ask an owner or admin to update your role or upgrade billing.
  </Accordion>

  <Accordion title="Can I belong to multiple organizations?">
    Yes. Switch between them from the sidebar organization switcher.
  </Accordion>

  <Accordion title="How do I export or delete organization data?">
    Owners open **Settings → Organization → Data and ownership**. Download a JSON copy, transfer ownership to another member, or delete the organization. Your personal account export and deletion stay under **Settings → Account**.
  </Accordion>
</AccordionGroup>

## Discord

<AccordionGroup>
  <Accordion title="Who can connect Discord?">
    Organization admins, when Discord Sync is included in your plan.
  </Accordion>

  <Accordion title="Sync did not update roles.">
    Confirm the server is connected, role mappings are correct, and the bot still has permission in Discord. Try a dry run, then a full sync.
  </Accordion>
</AccordionGroup>

## Scrims

<AccordionGroup>
  <Accordion title="Is SquadVault a scrim finder?">
    No. SquadVault runs Mission Control **after** a scrim is booked. Import from Gankster or schedule manually, then prep the team. See [Scrims](/user-guide/scrims).
  </Accordion>

  <Accordion title="Why does a calendar scrim open a workspace?">
    Scrim events open Mission Control instead of the generic edit dialog — prep, availability, and results live there.
  </Accordion>
</AccordionGroup>

## Feedback

<AccordionGroup>
  <Accordion title="Who can create surveys?">
    Staff with Feedback create permission, when Feedback surveys are included in your plan. Members typically only respond. See [Feedback](/user-guide/feedback).
  </Accordion>

  <Accordion title="Can surveys be filled without a SquadVault account?">
    Yes, if the survey access is **Public** and the survey is open. Share the public link from the builder. Cover images need the custom survey branding feature.
  </Accordion>
</AccordionGroup>

## Flows

<AccordionGroup>
  <Accordion title="My workflow did not run.">
    Confirm it is **active** (not draft), the trigger matches what you did, and check **Flows → Activity** for errors. See [Flows](/user-guide/flows).
  </Accordion>

  <Accordion title="How do I ping a whole team in Discord?">
    Add **Get team players**, then use `{{steps.N.discordMentions}}` in a Discord message. Details in [Flows reference](/user-guide/flows-reference).
  </Accordion>
</AccordionGroup>

## Billing

<AccordionGroup>
  <Accordion title="Who can change the plan?">
    Only organization owners and admins.
  </Accordion>

  <Accordion title="I upgraded but a feature is still locked.">
    Reload the app after a short wait. If it stays locked, open the billing portal to confirm the subscription, or contact support.
  </Accordion>
</AccordionGroup>

## API keys

<AccordionGroup>
  <Accordion title="Where do I create an API key?">
    **Integrations → API keys** (API feature required on your plan). See [Authentication](/api/authentication) and [Integrations](/user-guide/integrations).
  </Accordion>

  <Accordion title="What header do I send?">
    Send `x-api-key: YOUR_API_KEY` on every request to `https://api.squadvault.xyz/v1`. Organization keys do not need an internal gateway key.
  </Accordion>

  <Accordion title="Why do I get 403 with a valid key?">
    The key is valid but missing a permission for that action, or it belongs to a different organization. Check key permissions and the organization ID in the path or body.
  </Accordion>
</AccordionGroup>

## Audit log

<AccordionGroup>
  <Accordion title="Where is the audit log?">
    Under **Administration → Audit log** (owners and admins; Audit log feature required). See [Audit log](/user-guide/audit-log).
  </Accordion>

  <Accordion title="Why don’t I see an event I expect?">
    Only mutations are recorded. Confirm filters (source, outcome, area, search) are not hiding it, then use **Load more**.
  </Accordion>
</AccordionGroup>

## Still stuck?

Email [hello@squadvault.xyz](mailto:hello@squadvault.xyz) with your organization name, what you tried, and any error message or request ID you see.