---
title: "PUT /games/v1configuration/leaderboards/{leaderboardId}"
method: PUT
path: "/games/v1configuration/leaderboards/{leaderboardId}"
tags: ["leaderboardConfigurations"]
---

# PUT /games/v1configuration/leaderboards/{leaderboardId}

`PUT /games/v1configuration/leaderboards/{leaderboardId}`

## Request

- Base URL: `https://gamesconfiguration.googleapis.com`
- URL: `https://gamesconfiguration.googleapis.com/games/v1configuration/leaderboards/{leaderboardId}`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/androidpublisher`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/androidpublisher`
- TypeScript: <https://skmtc.dev/google/apis/gamesconfiguration/docs/games/v1configuration/leaderboards/:leaderboardId/put.ts> (a function with typed inputs; its response is checked against the schema)

Update the metadata of the leaderboard configuration with the given ID.

## Path parameters

- `leaderboardId` string, required

## Request body

- LeaderboardConfiguration: An leaderboard configuration resource.
  - `scoreOrder` 'SCORE_ORDER_UNSPECIFIED' | 'LARGER_IS_BETTER' | 'SMALLER_IS_BETTER'
  - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfiguration`.
  - `draft` LeaderboardConfigurationDetail: A leaderboard configuration detail.
    - `sortRank` integer: The sort rank of this leaderboard. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfigurationDetail`.
    - `scoreFormat` GamesNumberFormatConfiguration: A number format resource.
      - `numberFormatType` 'NUMBER_FORMAT_TYPE_UNSPECIFIED' | 'NUMERIC' | 'TIME_DURATION' | 'CURRENCY': The formatting for the number.
      - `currencyCode` string: The curreny code string. Only used for CURRENCY format type.
      - `suffix` GamesNumberAffixConfiguration: A number affix resource.
        - `two` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `few` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `many` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `zero` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `other` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `one` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
      - `numDecimalPlaces` integer: The number of decimal places for number. Only used for NUMERIC format type.
    - `name` LocalizedStringBundle: A localized string bundle resource.
      - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
      - `translations` LocalizedString[]: The locale strings.
        - `value` string: The string value.
        - `locale` string: The locale string.
        - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
    - `iconUrl` string: The icon url of this leaderboard. Writes to this field are ignored.
  - `published` LeaderboardConfigurationDetail: A leaderboard configuration detail.
    - `sortRank` integer: The sort rank of this leaderboard. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfigurationDetail`.
    - `scoreFormat` GamesNumberFormatConfiguration: A number format resource.
      - `numberFormatType` 'NUMBER_FORMAT_TYPE_UNSPECIFIED' | 'NUMERIC' | 'TIME_DURATION' | 'CURRENCY': The formatting for the number.
      - `currencyCode` string: The curreny code string. Only used for CURRENCY format type.
      - `suffix` GamesNumberAffixConfiguration: A number affix resource.
        - `two` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `few` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `many` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `zero` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `other` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `one` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
      - `numDecimalPlaces` integer: The number of decimal places for number. Only used for NUMERIC format type.
    - `name` LocalizedStringBundle: A localized string bundle resource.
      - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
      - `translations` LocalizedString[]: The locale strings.
        - `value` string: The string value.
        - `locale` string: The locale string.
        - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
    - `iconUrl` string: The icon url of this leaderboard. Writes to this field are ignored.
  - `token` string: The token for this resource.
  - `scoreMax` string, int64: Maximum score that can be posted to this leaderboard.
  - `id` string: The ID of the leaderboard.
  - `scoreMin` string, int64: Minimum score that can be posted to this leaderboard.

## Response `200`

Successful response

- LeaderboardConfiguration: An leaderboard configuration resource.
  - `scoreOrder` 'SCORE_ORDER_UNSPECIFIED' | 'LARGER_IS_BETTER' | 'SMALLER_IS_BETTER'
  - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfiguration`.
  - `draft` LeaderboardConfigurationDetail: A leaderboard configuration detail.
    - `sortRank` integer: The sort rank of this leaderboard. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfigurationDetail`.
    - `scoreFormat` GamesNumberFormatConfiguration: A number format resource.
      - `numberFormatType` 'NUMBER_FORMAT_TYPE_UNSPECIFIED' | 'NUMERIC' | 'TIME_DURATION' | 'CURRENCY': The formatting for the number.
      - `currencyCode` string: The curreny code string. Only used for CURRENCY format type.
      - `suffix` GamesNumberAffixConfiguration: A number affix resource.
        - `two` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `few` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `many` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `zero` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `other` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `one` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
      - `numDecimalPlaces` integer: The number of decimal places for number. Only used for NUMERIC format type.
    - `name` LocalizedStringBundle: A localized string bundle resource.
      - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
      - `translations` LocalizedString[]: The locale strings.
        - `value` string: The string value.
        - `locale` string: The locale string.
        - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
    - `iconUrl` string: The icon url of this leaderboard. Writes to this field are ignored.
  - `published` LeaderboardConfigurationDetail: A leaderboard configuration detail.
    - `sortRank` integer: The sort rank of this leaderboard. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#leaderboardConfigurationDetail`.
    - `scoreFormat` GamesNumberFormatConfiguration: A number format resource.
      - `numberFormatType` 'NUMBER_FORMAT_TYPE_UNSPECIFIED' | 'NUMERIC' | 'TIME_DURATION' | 'CURRENCY': The formatting for the number.
      - `currencyCode` string: The curreny code string. Only used for CURRENCY format type.
      - `suffix` GamesNumberAffixConfiguration: A number affix resource.
        - `two` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `few` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `many` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `zero` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `other` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
        - `one` LocalizedStringBundle: A localized string bundle resource.
          - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
          - `translations` LocalizedString[]: The locale strings.
            - `value` string: The string value.
            - `locale` string: The locale string.
            - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
      - `numDecimalPlaces` integer: The number of decimal places for number. Only used for NUMERIC format type.
    - `name` LocalizedStringBundle: A localized string bundle resource.
      - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedStringBundle`.
      - `translations` LocalizedString[]: The locale strings.
        - `value` string: The string value.
        - `locale` string: The locale string.
        - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#localizedString`.
    - `iconUrl` string: The icon url of this leaderboard. Writes to this field are ignored.
  - `token` string: The token for this resource.
  - `scoreMax` string, int64: Maximum score that can be posted to this leaderboard.
  - `id` string: The ID of the leaderboard.
  - `scoreMin` string, int64: Minimum score that can be posted to this leaderboard.

---

[API](https://skmtc.dev/google/apis/gamesconfiguration.md) - [All operations](https://skmtc.dev/google/apis/gamesconfiguration/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/gamesconfiguration/revisions/4b466b00bf86?raw)
