PATCH
/
v1
/
wallets
/
{wallet_id}
curl --request PATCH \
  --url https://api.privy.io/v1/wallets/{wallet_id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "policy_ids": [
    "tb54eps4z44ed0jepousxi4n"
  ]
}'
{
  "id": "jf4mev19seymsqulciv8on0c",
  "address": "0x7Ef5363308127128969618240eDcB9F8f61e90F6",
  "chain_type": "ethereum",
  "policy_ids": [
    "tb54eps4z44ed0jepousxi4n"
  ],
  "additional_signers": [],
  "owner_id": "rkiz0ivz254drv1xw982v3jq",
  "created_at": 1741362961254
}

Authorizations

Authorization
string
header
required

App secret authentication

Headers

privy-app-id
string
required

ID of your Privy app

privy-authorization-signature
string

Request authorization signature. If multiple signatures are required, they should be comma separated.

Path Parameters

wallet_id
string
required

ID of the wallet.

Body

application/json
policy_ids
string[]

New policy IDs to enforce on the wallet. Currently, only one policy is supported per wallet.

authorization_key_ids
string[]

New authorization key IDs to authorize actions on the wallet.

authorization_threshold
number

New authorization key threshold if a quorum of authorization keys is needed to authorize wallet actions.

Response

200 - application/json
Updated wallet object.
id
string
required

Unique ID of the wallet. This will be the primary identifier when using the wallet in the future.

address
string
required

Address of the wallet.

created_at
number
required

Unix timestamp of when the wallet was created in milliseconds.

chain_type
enum<string>
required

Chain type of the wallet. 'Ethereum' supports any EVM-compatible network.

Available options:
solana,
ethereum
policy_ids
string[]
required

List of policy IDs for policies that are enforced on the wallet.

owner_id
string
required

The owner of the wallet.

additional_signers
object[]
required

Additional signers for the wallet.

authorization_threshold
number

The number of authorization key signatures required to approve a transaction.

Was this page helpful?