Wallets
Remove Wallet
Unlink a wallet from a customer record
DELETE
/
customers
/
api
/
manage
/
{customerId}
/
wallets
/
{address}
curl -X DELETE "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets/0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52" \
-H "X-API-Key: trusset_your_key_here"
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets/0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52',
{
method: 'DELETE',
headers: { 'X-API-Key': 'trusset_your_key_here' }
}
);
const { data } = await response.json();
{
"success": true,
"data": {
"removed": true,
"address": "0x1234f9a07C6B53d81e2A4F70C9b385d6014a7E52"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}
Removes a linked wallet from a customer. The primary wallet cannot be removed this way: promote another wallet first with Promote Wallet, which demotes the current primary to a link.
Path Parameters
string
required
Customer record ID.
string
required
The linked wallet to remove, in any letter case.
Response Fields
object
Unlinking is a record-keeping act. Nothing on chain changes, and any identity verification or claims the wallet holds on the registry stay exactly as they were. To take those away, revoke the identity with Revoke Identity.
curl -X DELETE "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets/0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52" \
-H "X-API-Key: trusset_your_key_here"
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets/0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52',
{
method: 'DELETE',
headers: { 'X-API-Key': 'trusset_your_key_here' }
}
);
const { data } = await response.json();
{
"success": true,
"data": {
"removed": true,
"address": "0x1234f9a07C6B53d81e2A4F70C9b385d6014a7E52"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
INVALID_ADDRESS | 400 | address is not a valid address |
NOT_FOUND | 404 | No such customer, the record is archived, or that wallet is not linked to them. The primary is not a link, so it answers here too |
REMOVE_FAILED | 500 | The link could not be removed |
⌘I
curl -X DELETE "https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets/0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52" \
-H "X-API-Key: trusset_your_key_here"
const response = await fetch(
'https://api.trusset.org/customers/api/manage/cmt0k3b9x0004cghxw7r2d5ya/wallets/0x1234f9a07c6b53d81e2a4f70c9b385d6014a7e52',
{
method: 'DELETE',
headers: { 'X-API-Key': 'trusset_your_key_here' }
}
);
const { data } = await response.json();
{
"success": true,
"data": {
"removed": true,
"address": "0x1234f9a07C6B53d81e2A4F70C9b385d6014a7E52"
},
"metadata": {
"requestId": "550e8400-e29b-41d4-a716-446655440000",
"timestamp": "2026-09-30T12:00:00.000Z"
}
}