v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-12308185.7 KB

wallets

Update custody wallet

Update details for a specific custody wallet in your account.

This can be used to set (or clear) the Primary Domain (also known as the Reverse Resolution) for a custody wallet.

To clear the Primary Domain for a wallet, pass a null value for the primaryDomain property within the request body.

patch/account/wallets/{address}

Path parameters

addressstring required

Query parameters

$previewboolean

Allows simulating the operation creation (when set to true), without actually starting any processing. This can be used to validate the operation will be permitted and get a preview of the initial outcome.

When used, the operation in the response will have PREVIEW for all id and status values.

Request body

primaryDomainstring required

Example request

{
  "primaryDomain": "matt.crypto"
}

Response

@type'unstoppabledomains.com/partner.v3.WalletUpdateResult' required

Example response

{
  "operation": {
    "id": "op-4abb409c-9283-4589-bd36-d27a757a2165",
    "domain": "matt.crypto",
    "lastUpdatedTimestamp": 1684356429790,
    "dependencies": [
      {
        "id": "bc-2db427bd-5613-40c7-85b1-ab38beed0ed0",
        "parameters": {
          "initialRecords": {
            "crypto.ETH.address": "0xb4783AeF93923a2d4eEA29C84f347F26E62e4321",
            "crypto.MATIC.version.MATIC.address": "0xb4783AeF93923a2d4eEA29C84f347F26E62e5678",
            "crypto.MATIC.version.ERC20.address": "0xb4783AeF93923a2d4eEA29C84f347F26E62e0921"
          },
          "toAddress": "0xb4783AeF93923a2d4eEA29C84f347F26E62e4321"
        }
      }
    ]
  }
}