---
title: "Update Player"
method: POST
path: "/v1/players/{player_id}"
tags: ["Players"]
---

# Update Player

`POST /v1/players/{player_id}`

Update a player

## Path parameters

- `player_id` string, required

## Request body

- UserUpdate
  - `name` string
  - `email` string
  - `country` string
  - `banned` boolean
  - `banned_reason` string
  - `avatar_url` string
  - `attributes` PersistentPlayerAttributes
    - `level` integer
    - `platform` 'any' | 'ios' | 'android' | 'other'
    - `marketplace` 'none' | 'app_store' | 'google_play' | 'aghanim' | 'other' | 'one_store' | 'galaxy_store'
    - `device_type` 'Apple' | 'Android' | 'Unknown' | 'Other'
    - `tags` PlayerTag[]
    - `soft_currency_amount` integer
    - `hard_currency_amount` integer
    - `appsflyer_id` string
    - `appsflyer_app_id` string
    - `appsflyer_meta` object
    - `appsflyer_event_params` object
    - `appsflyer_customer_user_id` string
    - `adjust_device_id` object
    - `adjust_adid` string
    - `adjust_app_token` string
    - `adjust_authorization_token` string
    - `adjust_purchase_event_token` string
    - `adjust_callback_params` object
    - `adjust_partner_params` object
    - `singular_device_id` object
    - `singular_app_id` string
    - `devtodev_appid` string
    - `devtodev_apikey` string
    - `devtodev_device_id` DevtodevDeviceIdV2
      - `deviceId` string
      - `devtodevId` integer
      - `userId` string
      - `advertisingId` string
    - `ga4_client_id` string — GA4 web `client_id` from the `_ga` cookie.
    - `ga4firebase_app_instance_id` string — Firebase mobile `app_instance_id` from the SDK.
    - `ga4_user_id` string — Partner-set GA4 cross-device `user_id`; falls back to `User.player_id` when unset.
    - `saved_ach` boolean
    - `saved_card` boolean
    - `game_hub_last_sent_popup_unread` integer
    - `game_hub_last_sent_popup_read` integer
    - `prev_last_active_at` integer
    - `subscriptions` object
    - `purchases_count` integer
    - `is_pwa_installed` boolean
    - `pwa_visit_at` integer
    - `pwa_install_at` integer
    - `first_pwa_install_at` integer
    - `last_period_purchase_stat` object
    - `game_registered_at` integer
    - `game_first_login_ip` string
    - `game_account_verified` boolean
  - `custom_attributes` object
  - `segments` string[]
  - `creator_program_id` string
  - `registration_marketplace` 'none' | 'app_store' | 'google_play' | 'aghanim' | 'other' | 'one_store' | 'galaxy_store'
  - `balances` VirtualCurrencyShort[]
    - `sku` string, required
    - `quantity` integer, required
  - `marketing_consent` MarketingConsent
    - `email` EmailConsent
      - `granted_at` integer
      - `revoked_at` integer
  - `custom_attributes_from_deeplink` object

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/versions/0c1b4ac1865b/schema)