# TeamBattles

## Docs

- [Connections](https://teambattles.gg/docs/account/connections.md): Link your gaming and login accounts
- [Your Profile](https://teambattles.gg/docs/account/profile.md): Customize your profile and control your visibility
- [XP & Stats](https://teambattles.gg/docs/account/xp.md): Understanding experience points and statistics
- [Achievement Categories](https://teambattles.gg/docs/achievements/categories.md): All achievements organized by category
- [Achievements](https://teambattles.gg/docs/achievements/index.md): Track your progress and milestones
- [Onboarding Tasks](https://teambattles.gg/docs/achievements/onboarding.md): New user checklist to get started
- [Get League Bans](https://teambattles.gg/docs/api-reference/leagues/bans.md): Returns team bans for a specific league with optional status filtering. Requires API key with `leagues.league_admin` permission. The user must have MANAGER+ role in the league or be TB staff.
- [Discover Leagues](https://teambattles.gg/docs/api-reference/leagues/discover.md): Returns a paginated list of public leagues with optional search and game filtering. Requires API key with `leagues.league_public` permission.
- [Get League Members](https://teambattles.gg/docs/api-reference/leagues/members.md): Returns staff members for a specific league. Requires API key with `leagues.league_admin` permission. The user must have MEMBER+ role in the league or be TB staff.
- [Get League Penalties](https://teambattles.gg/docs/api-reference/leagues/penalties.md): Returns penalties and/or cooldowns for a specific league with optional filtering by type, team, and game. Requires API key with `leagues.league_admin` permission. The user must have MANAGER+ role in the league or be TB staff.
- [Get League Profile](https://teambattles.gg/docs/api-reference/leagues/profile.md): Returns the public profile for a specific league. The identifier is the league slug. Requires API key with `leagues.league_public` permission.
- [Get League Rules](https://teambattles.gg/docs/api-reference/leagues/rules.md): Returns game rules and points configuration for a specific league and game. The gameId parameter is required. Requires API key with `leagues.league_public` permission.
- [Get League Seasons](https://teambattles.gg/docs/api-reference/leagues/seasons.md): Returns seasons for a specific league with optional game and status filtering. Requires API key with `leagues.league_public` permission.
- [Get League Standings](https://teambattles.gg/docs/api-reference/leagues/standings.md): Returns standings (approved teams with stats) for a specific league. Each team includes a rank based on position. Requires API key with `leagues.league_public` permission.
- [Get Organization Matches](https://teambattles.gg/docs/api-reference/orgs/matches.md): Returns matches for all teams in an organization. The identifier can be a Convex org ID or org slug. Requires API key with `matches.org_matches` permission. User must be an active member of the organization.
- [Get Team Matches](https://teambattles.gg/docs/api-reference/teams/matches.md): Returns matches for a specific team. The identifier can be a Convex team ID or team slug. Requires API key with `matches.team_matches` permission. User must be an active member of the team.
- [Get Channel Badges](https://teambattles.gg/docs/api-reference/twitch/channel-badges.md): Returns Twitch channel-specific chat badges. These include subscriber badges with tier levels, bits badges, and other channel-specific badges.
- [Get Global Badges](https://teambattles.gg/docs/api-reference/twitch/global-badges.md): Returns Twitch global chat badges. These are badges available across all Twitch channels (e.g., Twitch Staff, Verified, Prime Gaming).
- [Get User Matches](https://teambattles.gg/docs/api-reference/user/matches.md): Returns matches where the authenticated user is on the roster. Only includes matches where the user was specifically added to the match roster (not just team membership). Supports filtering by status, game, date ranges, and opponent team. Results are paginated.
- [Match Chat](https://teambattles.gg/docs/chat/index.md): Communicate with opponents during matches
- [Sending Messages](https://teambattles.gg/docs/chat/messages.md): Text, images, replies, and reactions
- [Chat Settings](https://teambattles.gg/docs/chat/settings.md): Notifications and preferences
- [Dashboard](https://teambattles.gg/docs/dashboard.md): Your central hub for managing organizations, teams, and matches
- [Endpoint Reference](https://teambattles.gg/docs/developers/api-reference.md): Complete endpoint reference for the TeamBattles Developer API.
- [Authentication](https://teambattles.gg/docs/developers/authentication.md): Learn how to authenticate with the TeamBattles API using API keys and bearer tokens.
- [Overview](https://teambattles.gg/docs/developers/index.md): Build integrations with the TeamBattles API to submit scores, manage matches, and receive real-time event notifications.
- [Match Lifecycle](https://teambattles.gg/docs/developers/match-lifecycle.md): Query match details, rosters, and status through the TeamBattles API.
- [Score Submission](https://teambattles.gg/docs/developers/score-submission.md): Submit match scores programmatically using the TeamBattles API for both captain and game developer flows.
- [Webhooks](https://teambattles.gg/docs/developers/webhooks.md): Receive real-time event notifications from TeamBattles via webhook endpoints.
- [Discovery](https://teambattles.gg/docs/discovery/index.md): Find organizations and teams to join
- [Browsing Matches](https://teambattles.gg/docs/discovery/matches.md): Find matches to accept
- [Call of Duty: Black Ops 7](https://teambattles.gg/docs/games/cod-bo7.md): Game modes, maps, and requirements
- [Supported Games](https://teambattles.gg/docs/games/index.md): Games available on TeamBattles
- [League of Legends](https://teambattles.gg/docs/games/league-of-legends.md): League of Legends game support on TeamBattles.
- [Valorant](https://teambattles.gg/docs/games/valorant.md): Valorant game support on TeamBattles.
- [Welcome to TeamBattles](https://teambattles.gg/docs/index.md): The competitive esports platform for team-based match management
- [League Administration](https://teambattles.gg/docs/leagues/admin.md): Managing your league through the admin panel
- [Discovering Leagues](https://teambattles.gg/docs/leagues/discover.md): Find and browse competitive leagues
- [Leagues](https://teambattles.gg/docs/leagues/index.md): Organized competitive play with standings, seasons, and rule enforcement
- [Joining a League](https://teambattles.gg/docs/leagues/joining.md): Apply with your team to join a competitive league
- [Leaderboards & Points](https://teambattles.gg/docs/leagues/leaderboards.md): How league standings and the points system work
- [League Profiles](https://teambattles.gg/docs/leagues/profiles.md): Understanding league profile pages
- [League Rules](https://teambattles.gg/docs/leagues/rules.md): Game rules and match enforcement in leagues
- [Managing Seasons](https://teambattles.gg/docs/leagues/seasons.md): Create and manage competitive seasons for your league
- [Privacy Policy](https://teambattles.gg/docs/legal/privacy.md): Privacy Policy for TeamBattles competitive gaming platform
- [Terms of Service](https://teambattles.gg/docs/legal/terms.md): Terms of Service for TeamBattles competitive gaming platform
- [Accepting Matches](https://teambattles.gg/docs/matches/accepting.md): Find and accept challenges from other teams
- [Creating a Match](https://teambattles.gg/docs/matches/create.md): Challenge other teams to compete
- [Matches](https://teambattles.gg/docs/matches/index.md): Create challenges, accept opponents, and compete
- [Scores & Disputes](https://teambattles.gg/docs/matches/scores.md): Submit scores and resolve disagreements
- [Match Settings](https://teambattles.gg/docs/matches/settings.md): Maps, series length, and hosting
- [Notifications](https://teambattles.gg/docs/notifications/index.md): Stay updated on your teams and matches
- [Match Subscriptions](https://teambattles.gg/docs/notifications/subscriptions.md): Follow matches you're interested in
- [Creating an Organization](https://teambattles.gg/docs/organizations/create.md): Start your own gaming community
- [Organizations](https://teambattles.gg/docs/organizations/index.md): Create and manage gaming communities
- [Invites & Join Requests](https://teambattles.gg/docs/organizations/invites.md): Invite members and manage join requests
- [Members & Roles](https://teambattles.gg/docs/organizations/members.md): Manage organization members and permissions
- [Quick Start](https://teambattles.gg/docs/quickstart.md): Get started with TeamBattles in just a few minutes
- [Glossary](https://teambattles.gg/docs/reference/glossary.md): Terms and definitions
- [Quick Reference](https://teambattles.gg/docs/reference/index.md): Limits, constraints, and quick facts
- [Troubleshooting](https://teambattles.gg/docs/reference/troubleshooting.md): Solutions to common problems
- [Referrals](https://teambattles.gg/docs/referrals/index.md): Invite friends to TeamBattles and earn token rewards
- [Appearance](https://teambattles.gg/docs/settings/appearance.md): Theme and visual preferences
- [Connections](https://teambattles.gg/docs/settings/connections.md): Manage linked accounts
- [Game Stats](https://teambattles.gg/docs/settings/game-stats.md): Track and display your competitive ranks across supported games
- [Settings](https://teambattles.gg/docs/settings/index.md): Customize your TeamBattles experience
- [Billing](https://teambattles.gg/docs/subscriptions/billing.md): Manage your subscription and payment history
- [Subscriptions](https://teambattles.gg/docs/subscriptions/index.md): Unlock premium features and support TeamBattles
- [Organization Assignment](https://teambattles.gg/docs/subscriptions/organization.md): Assign your subscription benefits to an organization
- [Token Packs](https://teambattles.gg/docs/subscriptions/token-packs.md): Purchase tokens for the Token Store
- [Creating a Ticket](https://teambattles.gg/docs/support/create.md): Report issues and get help
- [Support](https://teambattles.gg/docs/support/index.md): Get help with issues and track requests
- [Managing Tickets](https://teambattles.gg/docs/support/manage.md): View, respond to, and resolve tickets
- [Creating a Team](https://teambattles.gg/docs/teams/create.md): Start a competitive team within your organization
- [Teams](https://teambattles.gg/docs/teams/index.md): Competitive units within organizations
- [Team Roles](https://teambattles.gg/docs/teams/roles.md): Understand team permissions and captaincy
- [Roster Management](https://teambattles.gg/docs/teams/roster.md): Manage active players and bench
- [API Permissions](https://teambattles.gg/docs/tools/battles-overlay/api-permissions.md): Overlays do not require an API key
- [OBS Dock](https://teambattles.gg/docs/tools/battles-overlay/dock.md): Manage your Battles Overlay directly from inside OBS Studio with the built-in dock panel
- [Editor Guide](https://teambattles.gg/docs/tools/battles-overlay/editor.md): How to use the overlay editor to customize your stream overlay
- [Battles Overlay](https://teambattles.gg/docs/tools/battles-overlay/index.md): Display your competitive stats live on your stream with customizable OBS overlays
- [Setup Guide](https://teambattles.gg/docs/tools/battles-overlay/setup.md): Step-by-step guide to setting up your Battles Overlay in OBS, Streamlabs, XSplit, and other streaming software
- [Simple Overlay](https://teambattles.gg/docs/tools/battles-overlay/simple.md): Add your game rank to your stream in seconds with no account required
- [Troubleshooting](https://teambattles.gg/docs/tools/battles-overlay/troubleshooting.md): Common issues and solutions for the Battles Overlay
- [Widget Reference](https://teambattles.gg/docs/tools/battles-overlay/widgets.md): Detailed reference for all overlay widgets
- [API Reference](https://teambattles.gg/docs/tools/battles-record/api.md): REST API and WebSocket for programmatic access
- [Battles Record](https://teambattles.gg/docs/tools/battles-record/index.md): Automatically record live streams from Twitch, YouTube, and Kick
- [Installation](https://teambattles.gg/docs/tools/battles-record/installation.md): Install Battles Record on Windows, Linux, or Docker
- [Jellyfin Integration](https://teambattles.gg/docs/tools/battles-record/jellyfin.md): Automatic media library updates with Jellyfin
- [Kick OAuth Proxy](https://teambattles.gg/docs/tools/battles-record/kick-oauth.md): Server-side OAuth token exchange for Kick platform authentication
- [Notifications](https://teambattles.gg/docs/tools/battles-record/notifications.md): Discord, Telegram, and webhook notifications
- [Platforms & Channels](https://teambattles.gg/docs/tools/battles-record/platforms.md): Add and configure Twitch, YouTube, and Kick channels
- [Post-Processing](https://teambattles.gg/docs/tools/battles-record/post-processing.md): Configure FFmpeg post-processing for recordings
- [Recordings](https://teambattles.gg/docs/tools/battles-record/recordings.md): Managing recordings and the recording lifecycle
- [Schedules](https://teambattles.gg/docs/tools/battles-record/schedules.md): Configure time-based recording schedules and content filtering
- [Storage](https://teambattles.gg/docs/tools/battles-record/storage.md): Configure recording directories, quotas, and retention policies
- [Troubleshooting](https://teambattles.gg/docs/tools/battles-record/troubleshooting.md): Common issues and solutions
- [Users & Authentication](https://teambattles.gg/docs/tools/battles-record/users.md): User roles, authentication, and session management
- [Battles Replay](https://teambattles.gg/docs/tools/battles-replay.md): Download VODs, record live streams, and replay chat from Twitch, Kick, and 1000+ sites
- [Tools](https://teambattles.gg/docs/tools/index.md): Official utilities and extensions
- [Interactive Tutorials](https://teambattles.gg/docs/tutorials.md): Step-by-step guided walkthroughs for common tasks on TeamBattles

## OpenAPI Specs

- [openapi](https://teambattles.gg/docs/api-reference/openapi.json)

## Optional

- [Discord](https://teambattles.gg/discord)
- [App](https://teambattles.gg)