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

Changes

Changed in 4 of the 21 revisions of this API.218

  • 82f2480cdb832See the full diff
    • ○

      api tag My Account added

      api-tag-added

    • ○

      api tag Users removed

      api-tag-removed

  • 4bed7522e6f8115See the full diff
    • ▲

      request property gameId was restricted to a list of enum values

      request-property-became-enum

    • ●

      the mode request property's maxLength was set to 64

      request-property-max-length-set

    • ○

      added the new call_of_duty_black_ops_7 enum value to the request property gameId

      request-property-enum-value-added

    • ○

      added the new counter_strike_2 enum value to the request property gameId

      request-property-enum-value-added

    • ○

      added the new league_of_legends enum value to the request property gameId

      request-property-enum-value-added

    • ○

      added the new valorant enum value to the request property gameId

      request-property-enum-value-added

    • ○

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

      request-property-min-length-decreased

  • 33b01a4694a71See the full diff
    • ○

      endpoint added

      endpoint-added

  • f22bd61fd5951See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 377 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog