Update Wallet

Edit online

Updates the metadata of an existing wallet. Only the wallet name and external identifier can be modified. All other properties remain unchanged.

HTTP request

PUT /wallets/{walletId}

Authorization requirements

Header	Type	Required	Description
`Authorization`	string	Yes	Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.
`X-DFNS-USERACTION`	string	Yes	User action signature used to authorize change-inducing requests. See User Action Signing flows for instructions on generating this signature.

Path parameter

Parameter	Type	Required	Description
`walletId`	string	Yes	Minimum length: 1 character.

Request body

Field	Type	Required	Description
`name`	string or null	No	Maximum length: 100 characters.
`externalId`	string or null	No	Maximum length: 100 characters.

curl --request PUT \
  --url https://api.digitalassets.ibm.com/wallets/{walletId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "name": "<string>",
  "externalId": "<string>"
}
'

Response

200: Success

Returns the updated wallet entity.

Example response:

{
  "id": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
  "network": "Ethereum",
  "address": "0x00e3495cf6af59008f22ffaf32d4c92ac33dac47",
  "name": "trading hot wallet",
  "signingKey": {
    "id": "key-6ece3-9l565-xxxxxxxxxxxxxxxx",
    "scheme": "ECDSA",
    "curve": "secp256k1",
    "publicKey": "e2375c8c9e87bfcd0be8f29d76c818cabacd51584f72cb2222d49a13b036d84d3d"
  },
  "status": "Active",
  "dateCreated": "2023-04-14T20:41:28.715Z",
  "custodial": true,
  "tags": []
}