My Account

Upsert one of the API key owner's game ranks

Changed on

Creates or overwrites the API key owner's rank for a single (gameId, mode) slot, forcing source to "api". The user is always derived from the API key. Requires game.ranks:read-write and the writes feature (api_pro).

post/user/game-ranks

Request

  • Base URL
    https://teambattles.gg/api/v1
  • URL
    https://teambattles.gg/api/v1/user/game-ranks
  • Auth
    HTTP bearer

Request body

gameId'call_of_duty_black_ops_7' | 'valorant' | 'league_of_legends' | 'counter_strike_2' required

Game definition ID to set the rank for (a playable game).

modestring required

Game mode / playlist the rank applies to (a valid playlist ID).

srinteger required

Skill rating (integer, 0-100000).

isTop250boolean

Whether the player is in the Top 250 ladder.

top250Rankinteger

Top 250 ladder position (1-250); only meaningful when isTop250.

winstreakinteger

Current win streak count (0-99).

Response

The game rank was created or updated.

idstring required

ID of the upserted game rank row.

timestampstring required

ISO 8601 response timestamp.

Changes

  • 82f2480cdb83Revision changes
    • info

      api tag My Account added

    • info

      api tag Users removed

  • 4bed7522e6f8Revision changes
    • breaking

      request property was restricted to a list of enum values

    • warning

      the request property's maxLength was set to 64

    • info

      added the new call_of_duty_black_ops_7 enum value to the request property

    • info

      added the new counter_strike_2 enum value to the request property

    • info

      added the new league_of_legends enum value to the request property

    • info

      added the new valorant enum value to the request property

    • info

      the request property's minLength was decreased from 1 to 0