---
title: "PUT /games/v1configuration/achievements/{achievementId}"
method: PUT
path: "/games/v1configuration/achievements/{achievementId}"
tags: ["achievementConfigurations"]
---

# PUT /games/v1configuration/achievements/{achievementId}

`PUT /games/v1configuration/achievements/{achievementId}`

## Request

- Base URL: `https://gamesconfiguration.googleapis.com`
- URL: `https://gamesconfiguration.googleapis.com/games/v1configuration/achievements/{achievementId}`
- 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/achievements/:achievementId/put.ts> (a function with typed inputs; its response is checked against the schema)

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

## Path parameters

- `achievementId` string, required

## Request body

- AchievementConfiguration: An achievement configuration resource.
  - `id` string: The ID of the achievement.
  - `stepsToUnlock` integer: Steps to unlock. Only applicable to incremental achievements.
  - `initialState` 'INITIAL_STATE_UNSPECIFIED' | 'HIDDEN' | 'REVEALED': The initial state of the achievement.
  - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#achievementConfiguration`.
  - `draft` AchievementConfigurationDetail: An achievement configuration detail.
    - `sortRank` integer: The sort rank of this achievement. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#achievementConfigurationDetail`.
    - `pointValue` integer: Point value for the achievement.
    - `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`.
    - `description` 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 achievement. Writes to this field are ignored.
  - `published` AchievementConfigurationDetail: An achievement configuration detail.
    - `sortRank` integer: The sort rank of this achievement. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#achievementConfigurationDetail`.
    - `pointValue` integer: Point value for the achievement.
    - `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`.
    - `description` 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 achievement. Writes to this field are ignored.
  - `token` string: The token for this resource.
  - `achievementType` 'ACHIEVEMENT_TYPE_UNSPECIFIED' | 'STANDARD' | 'INCREMENTAL': The type of the achievement.

## Response `200`

Successful response

- AchievementConfiguration: An achievement configuration resource.
  - `id` string: The ID of the achievement.
  - `stepsToUnlock` integer: Steps to unlock. Only applicable to incremental achievements.
  - `initialState` 'INITIAL_STATE_UNSPECIFIED' | 'HIDDEN' | 'REVEALED': The initial state of the achievement.
  - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#achievementConfiguration`.
  - `draft` AchievementConfigurationDetail: An achievement configuration detail.
    - `sortRank` integer: The sort rank of this achievement. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#achievementConfigurationDetail`.
    - `pointValue` integer: Point value for the achievement.
    - `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`.
    - `description` 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 achievement. Writes to this field are ignored.
  - `published` AchievementConfigurationDetail: An achievement configuration detail.
    - `sortRank` integer: The sort rank of this achievement. Writes to this field are ignored.
    - `kind` string: Uniquely identifies the type of this resource. Value is always the fixed string `gamesConfiguration#achievementConfigurationDetail`.
    - `pointValue` integer: Point value for the achievement.
    - `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`.
    - `description` 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 achievement. Writes to this field are ignored.
  - `token` string: The token for this resource.
  - `achievementType` 'ACHIEVEMENT_TYPE_UNSPECIFIED' | 'STANDARD' | 'INCREMENTAL': The type of the achievement.

---

[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)