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

# Update account

> Update an account by account ID. Supports updating the display name and adding new wallets.



## OpenAPI

````yaml patch /v1/accounts/{account_id}
openapi: 3.1.0
info:
  version: 0.0.1
  title: Privy API
  description: >-
    REST API for Privy's wallet infrastructure — provision and manage wallets
    across EVM, Solana, and Bitcoin, authenticate users, sign transactions, and
    configure programmable policies and authorization intents.
  contact:
    name: Privy
    url: https://www.privy.io/
    email: support@privy.io
servers:
  - url: https://api.privy.io
security: []
tags:
  - name: Accounts
    description: Operations related to asset accounts
  - name: Aggregations
    description: Operations related to aggregations for tracking and measuring metrics
  - name: Apps
    description: Operations related to app settings and allowlist management
  - name: Client Auth
    description: OAuth token exchange and device authorization operations
  - name: Condition Sets
    description: Operations related to condition sets
  - name: Embedded wallets
    description: Operations related to embedded wallet creation and authentication
  - name: Fiat
    description: Operations related to fiat onramping and offramping
  - name: Intents
    description: Operations related to authorization intents for wallet actions
  - name: Key quorums
    description: Operations related to key quorums
  - name: Kraken Embed
    description: >-
      Operations for Kraken Embed integration, including quotes, trades, user
      management, and portfolio operations
  - name: OAuth
    description: >-
      OAuth 2.0 endpoints including Device Authorization Grant (RFC 8628) for
      CLI and limited-input device login flows
  - name: Organizations
    description: Operations related to organization secret management
  - name: Policies
    description: Operations related to policies
  - name: Shared
    description: Common schemas shared across resources
  - name: Swaps
    description: Operations for swapping tokens within wallets
  - name: Transactions
    description: Operations related to transactions
  - name: User signers
    description: Operations related to user signers
  - name: Users
    description: Operations related to users
  - name: Wallet Actions
    description: Operations related to wallet actions
  - name: Wallets
    description: Operations related to wallets
  - name: Webhooks
    description: >-
      Webhook events that Privy sends to your configured endpoint when specific
      actions occur in your app
  - name: Yield
    description: >-
      Operations for depositing and withdrawing funds from ERC-4626 yield vaults
      (Morpho, Aave)
paths:
  /v1/accounts/{account_id}:
    patch:
      tags:
        - Accounts
      summary: Update account
      description: >-
        Update an account by account ID. Supports updating the display name and
        adding new wallets.
      operationId: updateAccount
      parameters:
        - schema:
            type: string
            minLength: 1
            description: ID of the account.
          required: true
          name: account_id
          in: path
        - schema:
            type: string
            description: ID of your Privy app.
          required: true
          name: privy-app-id
          in: header
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAccountInput'
            example:
              display_name: Updated Account Name
              wallets_configuration:
                - chain_type: ethereum
                - chain_type: solana
      responses:
        '200':
          description: The updated account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountResponse'
      security:
        - appSecretAuth: []
components:
  schemas:
    UpdateAccountInput:
      anyOf:
        - $ref: '#/components/schemas/UpdateAccountFromWalletsConfigurationInput'
        - $ref: '#/components/schemas/UpdateAccountFromWalletIdsInput'
      description: Input for updating a digital asset account.
      title: UpdateAccountInput
      x-stainless-model: accounts.update_account_input
    AccountResponse:
      type: object
      properties:
        id:
          type: string
          description: The account ID.
        display_name:
          type:
            - string
            - 'null'
          description: An optional display name for the account.
        wallets:
          type: array
          items:
            $ref: '#/components/schemas/AccountWallet'
          description: The wallets belonging to this account.
      required:
        - id
        - display_name
        - wallets
      description: A digital asset account that groups wallets under a single entity.
      title: AccountResponse
      x-stainless-model: accounts.account_response
    UpdateAccountFromWalletsConfigurationInput:
      type: object
      properties:
        display_name:
          $ref: '#/components/schemas/AccountDisplayName'
        wallets_configuration:
          $ref: '#/components/schemas/AccountWalletsConfiguration'
      additionalProperties: false
      description: >-
        Input for updating a digital asset account with a
        `wallets_configuration` specification.
      title: UpdateAccountFromWalletsConfigurationInput
      x-stainless-model: accounts.update_account_from_wallets_configuration_input
    UpdateAccountFromWalletIdsInput:
      type: object
      properties:
        display_name:
          $ref: '#/components/schemas/AccountDisplayName'
        wallet_ids:
          $ref: '#/components/schemas/AccountWalletIds'
      required:
        - wallet_ids
      additionalProperties: false
      description: >-
        Input for updating a digital asset account by adding existing wallets
        with a `wallet_ids` parameter.
      title: UpdateAccountFromWalletIdsInput
      x-stainless-model: accounts.update_account_from_wallet_ids_input
    AccountWallet:
      type: object
      properties:
        id:
          type: string
          description: The wallet ID.
        chain_type:
          $ref: '#/components/schemas/FirstClassChainType'
        custody:
          $ref: '#/components/schemas/WalletCustodian'
        address:
          type: string
          description: The on-chain address of the wallet.
      required:
        - id
        - chain_type
        - address
      description: A wallet belonging to a digital asset account.
      title: AccountWallet
      x-stainless-model: accounts.account_wallet
    AccountDisplayName:
      type: string
      description: An optional display name for the account.
      title: AccountDisplayName
      x-stainless-model: accounts.account_display_name
    AccountWalletsConfiguration:
      type: array
      items:
        $ref: '#/components/schemas/AccountWalletConfigurationItem'
      maxItems: 5
      description: Configuration for the wallets on this account.
      title: AccountWalletsConfiguration
      x-stainless-model: accounts.account_wallets_configuration
    AccountWalletIds:
      type: array
      items:
        type: string
      minItems: 1
      maxItems: 5
      description: IDs for wallets to include in this account.
      title: AccountWalletIds
      x-stainless-model: accounts.account_wallet_ids
    FirstClassChainType:
      type: string
      enum:
        - ethereum
        - solana
      description: The wallet chain types that offer first class support.
      title: FirstClassChainType
      x-stainless-model: wallets.first_class_chain_type
    WalletCustodian:
      type: object
      properties:
        provider:
          type: string
          description: The custodian responsible for the wallet.
        provider_user_id:
          type: string
          description: The resource ID of the beneficiary of the custodial wallet.
      required:
        - provider
        - provider_user_id
      description: Information about the custodian managing this wallet.
      title: WalletCustodian
      x-stainless-model: wallets.wallet_custodian
    AccountWalletConfigurationItem:
      type: object
      properties:
        chain_type:
          $ref: '#/components/schemas/FirstClassChainType'
        custody:
          $ref: '#/components/schemas/WalletCustodian'
      required:
        - chain_type
      additionalProperties: false
      description: Configuration for a wallet to create within an account.
      title: AccountWalletConfigurationItem
      x-stainless-model: accounts.account_wallet_configuration_item
  securitySchemes:
    appSecretAuth:
      type: http
      scheme: basic
      description: >-
        Basic Auth header with your app ID as the username and your app secret
        as the password.

````