# SquadVault

## Docs

- [SquadVault docs](https://docs.squadvault.xyz/index.md): Learn how to run your esports organization in SquadVault — from first setup to day-to-day workflows and the Public API.
- [Getting started](https://docs.squadvault.xyz/user-guide/getting-started.md): Set up your account, create your organization, and take the first steps that make SquadVault useful for your team.
- [Organizations](https://docs.squadvault.xyz/user-guide/organizations.md): Switch organizations, invite members, choose roles, and configure organization settings.
- [Teams and players](https://docs.squadvault.xyz/user-guide/teams-and-players.md): Build your roster with teams, player profiles, gamer tags, and staff assignments.
- [Calendar and availability](https://docs.squadvault.xyz/user-guide/calendar-and-availability.md): Schedule scrims and training, collect RSVPs, and plan around weekly availability.
- [Events](https://docs.squadvault.xyz/user-guide/scrims.md): Run Mission Control for scrims and tournaments — prep, availability, lobby details, and results in one workspace.
- [Tasks](https://docs.squadvault.xyz/user-guide/tasks.md): Assign work, set due dates, and keep coaches, managers, and players aligned.
- [Feedback](https://docs.squadvault.xyz/user-guide/feedback.md): Create organization surveys, collect member or public responses, and review answers in one place.
- [Recruitment](https://docs.squadvault.xyz/user-guide/recruitment.md): Run tryouts as an operational workspace: status first, then applications and assignments, with a public apply form.
- [Discord](https://docs.squadvault.xyz/user-guide/discord.md): Connect your Discord server, map roles, and keep roster membership in sync.
- [FACEIT](https://docs.squadvault.xyz/user-guide/faceit.md): CS roster health on Counter-Strike team workspaces — coverage, bans, Elo, and form. Stats stay on players and recruiting.
- [Integrations](https://docs.squadvault.xyz/user-guide/integrations.md): Health console for Discord, game tags, webhooks, and API keys — what needs attention next.
- [Flows](https://docs.squadvault.xyz/user-guide/flows.md): Automate Discord setup, notifications, and roster reactions with Trigger, Only if, and Then.
- [Flows reference](https://docs.squadvault.xyz/user-guide/flows-reference.md): Triggers, actions, and variables you can use when building Flows.
- [Webhooks](https://docs.squadvault.xyz/user-guide/webhooks.md): Send signed SquadVault events to your tools — and when to use Call webhook in Flows instead.
- [Documents](https://docs.squadvault.xyz/user-guide/documents.md): Upload playbooks and contracts, tag files, and link them from the calendar.
- [Audit log](https://docs.squadvault.xyz/user-guide/audit-log.md): See who changed what in your organization — filter, inspect details, and spot failures.
- [Billing](https://docs.squadvault.xyz/user-guide/billing.md): Understand plans, feature gates, and how to upgrade your organization.
- [FAQ](https://docs.squadvault.xyz/user-guide/faq.md): Answers to common questions about SquadVault accounts, organizations, Discord, Feedback, Flows, billing, and the API.
- [Introduction](https://docs.squadvault.xyz/api/introduction.md): Overview of the SquadVault Public API for scripts, bots, and external tools.
- [Authentication](https://docs.squadvault.xyz/api/authentication.md): Authenticate Public API requests with the x-api-key header.
- [Permissions](https://docs.squadvault.xyz/api/permissions.md): Required API key permissions for each Public API endpoint.
- [Errors](https://docs.squadvault.xyz/api/errors.md): Common Public API error responses and how to debug them.
- [Upload a document](https://docs.squadvault.xyz/api/upload-flow.md): Three-step flow to upload a private file to S3 and create a document record via the Public API.
- [List teams](https://docs.squadvault.xyz/api-reference/teams/list-teams.md): List all teams in the organization.
- [Create team](https://docs.squadvault.xyz/api-reference/teams/create-team.md): Create a new team.
- [Update team](https://docs.squadvault.xyz/api-reference/teams/update-team.md): Update team details or roster assignments.
- [Delete team](https://docs.squadvault.xyz/api-reference/teams/delete-team.md): Delete a team.
- [List players](https://docs.squadvault.xyz/api-reference/players/list-players.md): List all players in the organization.
- [Create player](https://docs.squadvault.xyz/api-reference/players/create-player.md): Create a new player with gamer tags.
- [Update player](https://docs.squadvault.xyz/api-reference/players/update-player.md): Update player details, team assignments, or archive status.
- [Delete player](https://docs.squadvault.xyz/api-reference/players/delete-player.md): Delete a player.
- [List documents](https://docs.squadvault.xyz/api-reference/documents/list-documents.md): List all documents in the organization.
- [Get document download URL](https://docs.squadvault.xyz/api-reference/documents/get-document-download-url.md): Create a short-lived download URL for a document.
- [Create document](https://docs.squadvault.xyz/api-reference/documents/create-document.md): Create a document record after uploading the file to object storage.
- [Update document](https://docs.squadvault.xyz/api-reference/documents/update-document.md): Update document metadata, tags, or replace the file.
- [Delete document](https://docs.squadvault.xyz/api-reference/documents/delete-document.md): Delete a document and its stored file.
- [List tryout applications](https://docs.squadvault.xyz/api-reference/tryout-applications/list-tryout-applications.md): List tryout applications for an organization. Requires `tryout:read` and the `tryout_management` plan feature.
- [Get tryout application](https://docs.squadvault.xyz/api-reference/tryout-applications/get-tryout-application.md): Get a single tryout application by ID. `organizationId` is required as a query parameter and must match the API key's organization.
- [Update tryout application](https://docs.squadvault.xyz/api-reference/tryout-applications/update-tryout-application.md): Update application status and/or internal notes. `organizationId` is required in the JSON body (not as a query parameter) and must match the API key's organization. Status changes emit domain events for Flows (`tryout.status_changed`, and `tryout.accepted` / `tryout.declined` when applicable).
- [Request document upload URL](https://docs.squadvault.xyz/api-reference/uploads/request-document-upload-url.md): Request a presigned upload URL for a new document file. Requires `document:create` on the organization. Documents are private: map `key` → `fileKey` and `fileRef` → `fileUrl` when creating the document. The API overwrites `fileUrl` with an opaque storage reference; downloads use signed URLs.

## OpenAPI Specs

- [openapi](https://docs.squadvault.xyz/openapi.yaml)