Ctrl+K

Create a wallet share

post/api/v2/{coin}/wallet/{walletId}/share

Share wallet with an existing BitGo user

Path Parameters

  • coinstringRequired
    A cryptocurrency or token ticker symbol.
    Example: "btc"
  • walletIdstringRequired
    Example: "59cd72485007a239fb00282ed480da1f"
    Pattern: ^[0-9a-f]{32}$

Request Body

permissions string
Comma-separated list of permissions (view, spend, admin) which are granted by this share. Required if "reshare" is false.
Example: spend,view
message string
User readable message to display to the share recipient
reshare boolean
Flag for reinviting a user to the wallet <br/> This is required if the invitee has already been invited to the wallet, but has changed their password and needs a new invite
skipKeychain boolean
Skips using a shared key (for when the wallet is shared without spend permission)
disableEmail boolean
Flag for disabling invite notification email
keychain object
Key passed to the receiving user, included if the wallet was shared with spend permission
pub string
One of wallet pub (onchain), commonPub (BLS) or commonKeychain (TSS)
encryptedPrv string
Private key of the user sharing the wallet encrypted under their wallet passphrase
fromPubKey string
Derived public key of the user sharing the wallet
toPubKey string
Derived public key of the user receiving the share
path string
BIP32 HD path of the derived public keys (fromPubKey and toPubKey)
Example: m/1234/1/1

200 Response

id
Wallet share id
coin
Coin of the wallet
wallet
Wallet id
walletLabel string
Example: My Wallet
fromUser
Id of the user sharing the wallet
toUser
Id of the user receiving the share
permissions string
Comma-separated list of permissions which are granted by this share
Allowed values: admin view spend
Example: spend,view
message string
Message for the user receiving the share
state string
State of the share
Allowed values: pendingapproval active accepted canceled rejected
Example: active
enterprise
If the wallet belongs to an enterprise, the id of that enterprise
pendingApprovalId
If the share generated a pending approval, the id of that pending approval

400 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code