Delete Wallets

Overview

You can delete wallets from your enterprise that you no longer want to use. Once you delete a wallet from your enterprise you can't view or access it. However, the wallet does remain visible and accessible to other wallet users. If you're the only wallet user, then the wallet must have a 0 balance before you can delete it from your enterprise. Therefore, to delete a wallet from your enterprise and prevent anyone from accessing it, transfer all assets out of the wallet and remove the users before deleting it.

Once deleted, the isDeleted boolean identifies wallets.

Prerequisites

• Get Started
• Create Wallets

Cookbook

Need just the steps? Expand the cookbook below to get started:

Steps

import { BitGoAPI } from '@bitgo/sdk-api';
import { Tstx } from '@bitgo/sdk-coin-stx';

// Fill in with actual access token
const accessToken = '<your_actual_access_token>';

const walletId = '<your_actual_wallet_id>';

// Initialize the SDK
const bitgo = new BitGoAPI({
  accessToken: accessToken,
  env: 'test',
});

const coin = '<your_coin_name>';
bitgo.register(coin, Tstx.createInstance);
const wallet = await bitgo.coin(coin).wallets().get({ id: walletId });
console.log('Wallet :', wallet);
const delWallet = await wallet.remove();
console.log('Wallet removed :', delWallet);

DELETE /api/v2/{coin}/wallet/{walletId}

Step Result

The wallet is no longer visible or accessible to you.

{
  "id": "7b748fbfe33ed2302839f634d1a6cf38",
  "users": [
    {
      "user": "55e8a1a5df8380e0e30e20c6",
      "permissions": [
        "admin",
        "spend",
        "view"
      ]
    }
  ],
  "coin": "tbtc4",
  "label": "Ops Wallet",
  "m": 2,
  "n": 3,
  "keys": [
    "7b748fbfe33ed2302839f635b2b7e04d",
    "7b748fbfe33ed2302839f639513433ca",
    "7b748fcfe33ed2302839f6d2314c1698"
  ],
  "keySignatures": {},
  "enterprise": "7b46c82dd57801812b3f789375fgfa94",
  "organization": "7b46c82dd57801812b3f7902b28f59df",
  "bitgoOrg": "BitGo Trust",
  "tags": [
    "7b748fbfe33ed2302839f634d1a6cf38",
    "7b46c82dd57801812b3f789375fgfa94"
  ],
  "disableTransactionNotifications": false,
  "freeze": {},
  "deleted": true,
  "approvalsRequired": 1,
  "isCold": true,
  "coinSpecific": {},
  "admin": {
    "policy": {
      "date": "2026-07-24T15:03:10.714Z",
      "id": "7b748fcfe33ed2302839f6d5a84503af",
      "label": "default",
      "rules": [
        {
          "id": "Custodial Wallet Whitelist",
          "lockDate": "2126-07-24T15:03:10.689Z",
          "mutabilityConstraint": "managed",
          "type": "advancedWhitelist",
          "action": {
            "type": "deny",
            "userIds": []
          },
          "condition": {
            "entries": []
          }
        }
      ],
      "version": 3,
      "latest": true
    }
  },
  "clientFlags": [],
  "walletFlags": [],
  "allowBackupKeySigning": false,
  "startDate": "2026-07-24T15:03:09.000Z",
  "type": "custodial",
  "buildDefaults": {},
  "customChangeKeySignatures": {},
  "hasLargeNumberOfAddresses": false,
  "multisigType": "onchain",
  "hasReceiveTransferPolicy": false,
  "creator": "7b46c82acc5801812b3f784ec2fa44af",
  "walletFullyCreated": true,
  "config": {}
}

See Also

API Reference: Delete Wallet