Remove Wallet Users

Overview

You can remove users from wallets. If there's more than a 1 wallet admin, removal requires approval by at least two admins.

Prerequisites

• Get Started
• Create Wallets
• Add Wallet Users

Cookbook

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

Steps

bitgo
  .coin('tbtc4')
  .wallets()
  .get({ id: walletId })
  .then(function (wallet) {
    wallet.removeUser({ userId: userId }).then(function (wallet) {
      console.dir(wallet);
    });
  });

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

Step Result

{
  "id": "6a3ad38ed8f6eb1bf6e4015c0095bf27",
  "users": [
    {
      "user": "6a35b719cc4690701a2f673da1e9931e",
      "permissions": ["admin", "spend", "view"]
    }
  ],
  "coin": "tbtc4",
  "label": "Ops Wallet",
  "m": 2,
  "n": 3,
  "keys": [
    "6a3ad38c19f4a569b2e2f09d1aee6818",
    "6a3ad38cd8f6eb1bf6e400e971f3353a",
    "6a3ad38e19f4a569b2e2f0c435ee1eea"
  ],
  "keySignatures": {
    "backupPub": "3a8f2c7d1e9b4a6f0c5d8e3b2a7f1c4d9e6b3a0f7c2d5e8b1a4f9c6d3e0b7f2a5c8d1e4b9a6f3c0d7e2b5a8f1c4d9e6b3a0f7c2d5e8b1a4f9c6d3e0b7f2a5c8",
    "bitgoPub": "1c4f9b2e7a3d6c0f5b8a1e4c9f2b5a8d3e6a0c3f6b9d2e5a8c1f4b7a0d3e6c9f2b5d8a1e4c7f0b3d6a9e2c5f8b1d4a7e0c3f6b9d2e5a8c1f4b7a0d3e6c9f2b5d8"
  },
  "enterprise": "6a35b71ccc4690701a2f678264effb83",
  "organization": "6a35b71ccc4690701a2f6791a17e48ce",
  "bitgoOrg": "BitGo Trust",
  "tags": [
    "6a3ad38ed8f6eb1bf6e4015c0095bf27",
    "6a35b71ccc4690701a2f678264effb83"
  ],
  "disableTransactionNotifications": false,
  "freeze": {
    "time": "2026-07-23T02:03:14.172Z",
    "expires": "2026-07-23T02:03:14.172Z",
    "reason": "UserRequest",
    "referenceId": "cmrq4n8bk0hj20ez9bfx3m7va",
    "adminOrUserId": "6a35b719cc4690701a2f673da1e9931e"
  },
  "deleted": false,
  "approvalsRequired": 1,
  "isCold": false,
  "coinSpecific": {},
  "admin": {},
  "clientFlags": [],
  "walletFlags": [],
  "allowBackupKeySigning": false,
  "recoverable": false,
  "startDate": "2026-06-23T18:42:22.000Z",
  "type": "hot",
  "buildDefaults": {},
  "customChangeKeySignatures": {},
  "hasLargeNumberOfAddresses": false,
  "multisigType": "onchain",
  "hasReceiveTransferPolicy": false,
  "creator": "6a35b719cc4690701a2f673da1e9931e",
  "walletFullyCreated": true,
  "config": {},
  "balance": 100000,
  "balanceString": "100000",
  "rbfBalance": 0,
  "rbfBalanceString": "0",
  "confirmedBalance": 100000,
  "confirmedBalanceString": "100000",
  "spendableBalance": 100000,
  "spendableBalanceString": "100000",
  "unspentCount": 0,
  "receiveAddress": {
    "id": "6b1e4a9f3c7d2b0e5f8a1c4d7e0b3f6a",
    "address": "tb1qp8wnzg4xktjumr9v2lf5qz93hyuep8n6rwlg0zgcmtlm85afylkqngkef2",
    "chain": 20,
    "index": 12,
    "coin": "tbtc4",
    "wallet": "6a3ad38ed8f6eb1bf6e4015c0095bf27",
    "coinSpecific": {
      "witnessScript": "52210241dc07c43cdba529410916a5a9f2d4c1993faa61d10c3dde01b51db404256fae21035eb0b81fef9d543f1c5d05b304c0b08a55a81e0f4c3b89691f7e514950bf8f6a2103ec8df81a87744d94e549b2615fffd370c2f3e35ae686a89c9cf084fa2cbbf45653ae"
    }
  },
  "pendingApprovals": []
}

See Also

API Reference: Remove user from Wallet