v20

OpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB

My Account

Upsert one of the API key owner's game ranks

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