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"
  ],
  "owner_id": "rkiz0ivz254drv1xw982v3jq",
  "additional_signers": [],
  "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.

​
owner
object | null

The P-256 public key of the owner of the wallet. If you provide this, do not specify an owner_id as it will be generated automatically.

​
owner_id
string | null

The key quorum ID to set as the owner of the wallet. If you provide this, do not specify an owner.

​
additional_signers
object[]

Additional signers for the wallet.

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,
cosmos,
stellar
​
policy_ids
string[]
required

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

​
owner_id
string
required

The key quorum ID of the owner of the wallet.

​
additional_signers
object[]
required

Additional signers for the wallet.

​
public_key
string

The compressed, raw public key for the wallet along the chain cryptographic curve.