> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update User

> Updates a user. A user token updates their own global profile; an API key updates the user's account-specific profile override (account_id required).



## OpenAPI

````yaml /openapi/api-v1-native.yml patch /users/{id}
openapi: 3.1.0
info:
  title: Whop API
  description: >-
    Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema
    at build time.
  version: v1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.whop.com/api/v1
security: []
paths:
  /users/{id}:
    parameters:
      - $ref: '#/components/parameters/ApiVersionDate'
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: User ID (prefixed `user_`), username, or `me`.
    patch:
      tags:
        - Users
      summary: Update User
      description: >-
        Updates a user. A user token updates their own global profile; an API
        key updates the user's account-specific profile override (account_id
        required).
      operationId: updateUser
      parameters:
        - name: account_id
          in: query
          schema:
            type: string
          required: false
          description: >-
            The account whose profile override to update. Required for API key
            callers.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                bio:
                  type: string
                username:
                  type: string
                profile_picture:
                  type: object
                  properties:
                    id:
                      type: string
                    direct_upload_id:
                      type: string
        required: true
      responses:
        '200':
          description: user updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
      security:
        - bearerAuth:
            - user:profile:update
components:
  parameters:
    ApiVersionDate:
      name: Api-Version-Date
      in: header
      required: false
      schema:
        type: string
        format: date
        example: '2026-07-01'
      description: >-
        Pins the request to a dated API version. When omitted, the request uses
        the original (2025-01-01) request/response shapes, so existing
        unversioned callers are never broken. Generated SDKs always send the
        latest version they were built against. An unrecognized value is
        rejected with a 400. The schemas documented here always describe the
        latest version.
  schemas:
    User:
      type: object
      properties:
        id:
          type: string
          description: User ID, prefixed `user_`.
        username:
          type: string
          description: The user's unique username
        name:
          type:
            - string
            - 'null'
          description: The user's display name
        bio:
          type:
            - string
            - 'null'
          description: The user's biography
        created_at:
          type: string
          description: When the user was created, as an ISO 8601 timestamp
        profile_picture:
          type:
            - object
            - 'null'
          description: The user's profile picture, an object with a url
        total_usd:
          type:
            - string
            - 'null'
          description: >-
            Total USD value across the user's balances with known exchange
            rates. Computed only on `GET /users/me` self-view for callers with
            balance-read scope; `null` otherwise.
        balances:
          type: array
          items:
            $ref: '#/components/schemas/AccountBalanceToken'
            description: >-
              User holdings (crypto and fiat), each with USD value. Empty when
              `total_usd` is `null`.
        verification:
          type: object
          description: >-
            Identity verification status for the user's `individual` (KYC) and
            `business` (KYB) profiles. Each is `null` until created, otherwise a
            `status` of `not_started`, `pending`, `approved`, or `rejected`.
      required:
        - id
        - username
        - name
        - bio
        - created_at
        - profile_picture
        - total_usd
        - balances
        - verification
    AccountBalanceToken:
      type: object
      properties:
        symbol:
          type: string
          description: Holding display symbol, such as `USDT`, `cbBTC`, or `EUR`.
        name:
          type: string
          description: The holding's display name
        balance:
          type: string
          description: Total amount held in native units, as a decimal string.
        value_usd:
          type:
            - string
            - 'null'
          description: Holding USD value, or `null` when no exchange rate is available.
        price_usd:
          type:
            - number
            - 'null'
          description: USD price per unit, or `null` when no exchange rate is available.
        icon_url:
          type:
            - string
            - 'null'
          description: Holding icon URL.
        breakdown:
          type: object
          description: >-
            Balance split into available, pending, and reserve amounts, as
            native-unit decimal strings. On-chain crypto is entirely available;
            good_funds and fiat cash can have pending or reserve portions.
      required:
        - symbol
        - name
        - balance
        - value_usd
        - price_usd
        - icon_url
        - breakdown
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        An account API key, account scoped JWT, app API key, or user OAuth
        token.

````