Skip to main content

Documentation Index

Fetch the complete documentation index at: https://teambattles.gg/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Account Issues

“I can’t log in”
  • Try a different login provider
  • Clear browser cache and cookies
  • Check if the OAuth provider is having issues
“I can’t unlink my Discord/Twitch”
  • Keep at least one provider connected
  • Link a different provider first, then unlink
“My profile picture won’t upload”
  • Check file is under 1 MB
  • Ensure it’s an image (JPG, PNG, GIF, WebP)
  • The image may have been flagged as inappropriate by our automatic content filter
  • Try a different browser

​
Organization Issues

“I can’t create a team”
  • You must be Owner or Admin
  • Ask an admin to promote you or create the team
“I can’t invite members”
  • Managers can invite, Members cannot
  • Ask an admin to promote you

​
Team Issues

“I can’t join this team”
  • You must be in the parent organization first
  • You may be banned from the team
  • The team may be disabled
“I was demoted when I promoted someone”
  • Each team has only one Captain
  • Promoting someone to Captain makes you Co-Captain

​
Match Issues

“I can’t start a match”
  • Only captains can start matches
  • Both teams must have confirmed rosters
  • Match must be “Accepted” status
“I can’t submit scores”
  • Only captains can submit
  • Match must be “In Progress”
  • Verify you have active players
“I can’t accept a match”
  • Your team must be for the same game
  • You must be Captain or Co-Captain
  • Meet platform/input requirements

​
Chat Issues

“I can’t send messages”
  • You may be rate limited (5/minute)
  • Wait for countdown timer
  • Keep messages under 255 characters
“I can’t upload images”
  • Team may have reached 10 image limit
  • Images must be under 2 MB
  • The image may have been flagged as inappropriate by our automatic content filter
“Where did my messages go?”
  • Chat is deleted 48 hours after match completion
  • Screenshot important messages before match ends

​
Connection Issues

“I can’t link my Activision”
  • Ensure correct Activision account
  • Log out and back in
  • Clear browser cache
“I can’t play CoD without Activision”
  • Activision is required for Call of Duty
  • Go to Settings > Connections to link

​
Achievement Issues

“My achievement didn’t unlock”
  • Achievements unlock automatically
  • Try refreshing the page
  • Some need a short delay
“The onboarding won’t disappear”
  • Complete all tasks in each category
  • Some tasks have specific requirements

​
League Issues

“I can’t create a league”
  • League creation requires a TB staff-approved application. Navigate to Discover > Leagues > Create League to submit your application.
  • Check if you have reached your league ownership limit (varies by subscription tier).
“My team can’t join a league”
  • Your team must have at least the minimum roster size required by the league.
  • Check if your team is banned from the league.
  • If you recently left the league, a cooldown period may apply.
“I can’t see my points or standings”
  • Points are only tracked during active seasons. Check if the league has an active season for your game.
  • Scrimmage matches (outside active season) may not award points depending on league settings.
“My league appears as orphaned”
  • This happens when the league owner’s account is banned. Contact TB staff through the support system for assistance.

​
Tutorial Issues

“My tutorial is stuck or not advancing”
  • Make sure you’re clicking the highlighted element, not elsewhere on the page
  • If the highlighted element isn’t visible, try scrolling or navigating to the expected page
  • Close the tutorial and restart it from the dashboard
“The tutorial badge won’t go away”
  • The floating “Tutorial in progress” badge means a tutorial is paused. Click it to cancel, or complete the expected action to resume.
  • Paused tutorials are automatically abandoned after 24 hours.
“I want to replay a tutorial”
  • Go to your dashboard and find the Tutorials section. Completed tutorials can be started again at any time.

​
API Key Issues

“I can’t create more keys”
  • Maximum 5 API keys per account
  • Delete unused keys to free up slots
“My API key isn’t working”
  • Verify key is copied correctly (starts with tb_)
  • Check the key has required permissions
  • Use correct header format: Bearer tb_...
“Permission denied errors”
  • Edit the key to add required permissions
  • Connection permissions need platform linked first
“Can’t enable a connection permission”
  • Link that platform in Settings > Connections first
“I lost my API key”
  • Keys are only shown once at creation
  • Create a new key and update your applications

​
Invalid cursor error (error_invalid_cursor)

If you receive a 400 error_invalid_cursor response from /api/v1/user/matches, /api/v1/teams/[identifier]/matches, or /api/v1/orgs/[identifier]/matches, the cursor you passed was not produced by a recent response from the same endpoint. Common causes:
  • The cursor format changed between versions. If you stored a cursor from the legacy response envelope ({ matches, pagination: { cursor, hasMore } }), it will not work against the new native envelope ({ page, isDone, continueCursor }). Re-issue a fresh numItems request with no cursor to start a new pagination run.
  • The cursor was truncated in storage or transit (e.g., URL length limits).
  • A deploy invalidated server-side pagination state.
Fix: drop the stored cursor, call the endpoint again without cursor, and use the continueCursor from the new response for subsequent pages.