Ctrl+K

Admin Update Enterprise

put/api/v1/admin/enterprise/{enterpriseId}

Admin route to update enterprises

Path Parameters

  • enterpriseIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
    Min length: >= 1 characters

Request Body

bitgoOrg string
BitGo Organization related to this entity
Min length: >= 1 characters
canAccessBorrowing boolean
whether the enterprise has the licence for BitGo Prime Borrowing
canAccessLending boolean
whether the enterprise has the licence for BitGo Prime Lending
canAccessSettlement boolean
whether the enterprise has the licence to utilize settlement functionality - requires a trading account
canAccessTrading boolean
whether the enterprise has the licence to access BitGo Trading - requires Portfolio and a trading account
canCreateColdWallet boolean
whether the enterprise has the license to create cold wallets
canCreateCustodialWallet boolean
whether the enterprise has the license to create custodial wallets
canCreateHotWallet boolean
whether the enterprise has the license to create hot wallets
canCreateOffchainWallet boolean
whether the enterprise has the license to create trading accounts - only available for BitGo Trust entities with a DAS
ellipticHotWallets boolean
Enable Elliptic monitoring for hot wallet transactions of this enterprise
ethAlwaysUseHop boolean
Always use hop address for ETH transactions
useHsmRegionalRouting boolean
ellipticId string
Identifier for environment variables for a customer's Elliptic API credentials. Recommended to be 10 random uppercase letters
Min length: >= 1 characters
emergencyPhone string
Phone number for emergencies
Min length: >= 1 characters
Example: +11234567890
internal object
migratedToNewPolicyService boolean required
Whether the enterprise has been migrated to the new policy service
isBitGoControlledEnterprise boolean
isBitGoTestEnterprise boolean
financialReportingEntity string
Allowed values: BitGo Holdings, Inc. BitGo Ecosystem Holdings LLC BitGo Financial LLC BitGo Holdings EMEA Ltd BitGo Custody MENA FZE (UAE) BitGo Europe Denmark BitGo Europe GmbH BitGo GmbH BitGo Hong Kong Ltd BitGo MENA FZE (UAE) BitGo Korea, Inc. BitGo New York Trust Company LLC BitGo Prime BitGo Prime UK Ltd BitGo Technologies LLC BitGo Technologies India Private Limited BitGo Trust Co. Inc BitGo, Inc BitGo Canada BitGo Europe LTD BitGo India Private Limited BitGo Japan KK BitGo Singapore Pte. LTD BitGo Taiwan Brassica Technologies Inc. Brassica Services LLC Brassica Trust Company LLC Brassica Ventures LLC Republic Asia Advisors Pte Go Technologies Ltd (Cayman Islands) HeightZero
purpose string
latestSAVersionSigned number
featureFlags array[string]
licenses array[string]
Allowed values: bitgoNetwork marginTrading metaMaskInstitutional mtGox portfolioAPI portfolioBasic portfolioProfessional portfolioInstitutional tax tradeAPI staking stakingApi cryptoCompare elliptic instantFeeHotWallet bitgoTrustAsKrs escrow escrowTriparty distributedCustodyWallet selfCustodyLightningWallet custodyLightningWallet custodyGoLightning achDebits advancedWallets stablecoins canBorrowAgainstGoAccount
labels array[string]
Allowed values: B2B2C - Swan B2B2C - Binance B2B2C - Fold Sofi Mt Gox Bitcoin Builder Employee General B2B2C B2B2B - Keyrails B2B2B - Onramp B2B2C - Onramp starterAccount ftx bitgoTechnologiesFBO retail foundation
mutablePolicyWindow number
Time in seconds after which policies on this Enterprise cannot be updated
Example: 86400
name string
Min length: >= 1 characters
Example: Example Enterprise Name
type string
Allowed values: Asset Management (i.e. pension fund) Bank Broker/Dealer Casinos and Gambling Establishments Charity/NGO/Non-Profit/Foundation/Endowment Commodities/Futures Commission Merchant Crypto ATM Crypto Exchange Crypto Lending/Borrowing Custodian Family Office Foreign Correspondent Banks Government/State owned/Political Org. (i.e. Sovereign Wealth Fund) Individual Import/export companies Insurance Company Miner / Mining Pool Money Service Business Mutual Funds Non-Banking Financial Institution (NBFI) (ETF Issuer, Forex, Index Fund, Hedge Fund, RIA, Prime Brokerage) OTC Payment Platforms Private Equity / Venture Capital Private Investment Companies/International Business Corporations Professional Service Providers (lawyers, accountants, etc.) Real estate brokers, developers, and appraisers Retail Lender Software or Technology Company Tokens / Coins Traders / Trading (High Frequency, Proprietary, Market Maker) Agriculture Art dealer / Auctioneer Computer programmer/ administrator / software engineer / IT Education / Teacher Extractive industry (oil, gas, iron, steel, copper, earth metals) Film / TV / Entertainment (not adult) Healthcare Jewels / gemstones / precious metals Recreation / hospitality Student Unemployed / Retired High Net Worth Individual Law Enforcement / Military / Protective Services Weapons dealers Leveraged Investor Institutional Investors Financial Institution Execution Services Other
primaryContact string
The email of the User who should be the new primary contact
Min length: >= 1 characters
Example: user@email.com
pricingTypes array[string]
pricingPlan string
The pricing plan of the enterprise
preferredUi string
Allowed values: bg23
walletLimit dictionary<string, number>
Total number of wallets this enterprise can create for a coin
Example: {"ofc":1}
number
custodialWalletLimit dictionary<string, number>
Number of custodial wallets this enterprise can create for a coin
Example: {"btc":1}
number
selfCustodyLightningWalletLimits dictionary<string, number>
Number of self custody lightning wallets the enterprise can create for a coin
number
custodyLightningWalletLimits dictionary<string, number>
Number of custody lightning wallets the enterprise can create for a coin
number
salesforceAccountId string
Opportunity ID from Salesforce
Min length: >= 1 characters
approvedVideoIdUsers array[string]
Enterprise users that can do custodial video approval. Required to have initial video ID done.
usersViewAllWallets boolean
All users on the enterprise can view all enterprise wallets, even if they are not viewers on the wallet itself
videoIdWaived boolean
Whether the customer has waived the need for Video ID on low risk withdrawals.
cheetahAccountId string
CheetahAccountID is the unique ID for a BitGo Trust enterprise in Cheetah, which is the accounting system used by Trust.
Min length: >= 1 characters
legalIdentifiers object
legalPersonName string required
Min length: >= 1 characters
additionalEnterpriseInfo object
contact object
vaspId string
upfrontPaymentStatus string
signupDomain string
Min length: >= 1 characters
contractStartDate string <date-time>
The contract start date for an enterprise
contractEndDate
string or null
<date-time>
The contract end date for an enterprise
contractIsExternal boolean
Specifies if it is an external contract
distributedCustody object
signingBitgoOrg
string or null
required
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1 BitGo Inc
accountType
string or null
Indicates which type of KYC process the enterprise has to complete
Allowed values: individual entity
businessModel string
Allowed values: bitgoAsAService cryptoAsAServiceParent cryptoAsAServiceChild

200 Response

organization string
Organization ID reference
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
permissions array[string]
Permissions of the User on the Enterprise
Allowed values: admin auditor
isBeneficialOwner boolean
acceptedInvite boolean
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
name string required
Example: Small Company
bitgoOrg string required
BitGo Organization related to this entity
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1 BitGo Inc
kycState string required
Allowed values: unverified approved rejected pending qrscanned inreview flagged flagged_retry_allowed
legalIdentifiers object required
legalPersonNameIdentifierType string required
Allowed value: LEGL
legalPersonName string
type string required
latestSAVersionSigned number required
Example: 0
travelRule boolean required
productLicenses array[string] required
canAccessBorrowing boolean required
whether the enterprise has the licence for BitGo Prime Borrowing
canAccessLending boolean required
whether the enterprise has the licence for BitGo Prime Lending
canAccessSettlement boolean required
whether the enterprise has the licence to utilize settlement functionality
canAccessTrading boolean required
whether the enterprise has the licence to access BitGo Trading
canCreateColdWallet boolean required
whether the enterprise has the license to create cold wallets
canCreateHotWallet boolean required
whether the enterprise has the license to create hot wallets
canCreateCustodialWallet boolean required
whether the enterprise has the license to create custodial wallets
canCreateOffchainWallet boolean required
whether the enterprise has the license to create trading accounts
oneTimeFees array[string] required
upfrontPaymentStatus string required
ethAlwaysUseHop boolean required
Always use hop address for ETH transactions
usersViewAllWallets boolean required
All users on the enterprise can view all enterprise wallets, even if they are not viewers on the wallet itself
Example: true
videoIdWaived boolean required
Whether the customer has waived the need for Video ID on low risk withdrawals.
Example: false
additionalEnterpriseInfo object
contact object
tradeOnboardingAgreement object
Who & when the MPA license was ack'd
user string required
dateOne ofrequired
ip string
stakingServicesAgreement object
For users doing self-service onboarding, they just need to click a checkbox to agree to the terms. we will track who & when that happened on a feature-by-feature basis.
user string required
dateOne ofrequired
ip string
custodyServicesAgreement object
For users doing self-service onboarding, they just need to click a checkbox to agree to the terms. we will track who & when that happened on a feature-by-feature basis.
bitgoOrg string
BitGo Organization related to this custody service agreement
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1 BitGo Inc
user string required
dateOne ofrequired
ip string
stablecoinAgreement array[object]
Stablecoin agreement schema for enterprise users.
user string required
User who accepted the agreement
dateOne ofrequired
Date when the agreement was accepted
ip string
IP address of the user
version number required
Version number of the agreement
accountType string
Indicates which type of KYC process the enterprise has to complete
Allowed values: individual entity
businessModel string
Allowed values: bitgoAsAService cryptoAsAServiceParent cryptoAsAServiceChild
salesforceAccountId string
Opportunity ID from Salesforce
salesforceOpportunityId string
opportunityName string
Opportunity Name from Salesforce
salesEmail string
cheetahAccountId string
CheetahAccountID is the unique ID for a BitGo Trust enterprise in Cheetah, which is the accounting system used by Trust.
primaryContact string
The Id of the User who is the primary contact
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
emergencyPhone string
Phone number for emergencies
Example: +11234567890
pricingPlan string
The pricing plan of the enterprise
approvalsRequired number
How many Enterprise Admins are required for action to fire
Example: 1
mutablePolicyWindow number
Time in seconds after which policies on this Enterprise cannot be updated
Example: 172800
freeze object
timeOne of
When the freeze started
expiresOne of
When the freeze will end
reason string
The reason the entity was frozen
frozenBy string
The user that froze the entity
unFrozenBy string
The user that unfroze the entity
bitgoEthKey string
The public portion of the ethererum key generated for the enterprise fee address
ethFeeAddress string
The eth fee address used to pay for network transaction fees of this enterprise
walletLimit dictionary<string, number>
number
preferredUi string
The UI that this enterprise prefers to use
Allowed values: bg23
custodialWalletLimit
dictionary<string, number> or null
number
featureFlags array[string]
labels array[string]
publicLabels array[string]
Subset of labels that are OK to return back to client in GetEnterpriseResponse
licenses array[string]
New licences that are not stored as flags. Tax requires Portfolio Professional or Institutional
ellipticId string
Identifier for environment variables for a customer's Elliptic API credentials
ellipticHotWallets boolean
Hot wallet transactions on this enterprise are monitored in Elliptic
vaspId string
bitgoVaspId string
coinSpecific object
walletCounts object
Number of wallets per coin
enterpriseWallets dictionary<string, number> required
activePricingType
object or null
name string required
Allowed values: starter growth employee FTX Retail FTX Institutional
startDateOne ofrequired
ISO 8601 Datetime (example at https://datatracker.ietf.org/doc/html/rfc3339#section-5.8). If present, will use as the start date of a new auditable item. If not present, will use the current date to create a new auditable item. Start date is inclusive, i.e. we will start billing/functionality at this instant and afterwards.
startReason string required
An optional note describing the reason the auditable item was added/created.
id string
Unique identifier for the date range.
endDateOne of
ISO 8601 Datetime (example at https://datatracker.ietf.org/doc/html/rfc3339#section-5.8). If present, will use as the end date of a new auditable item. If not present, we will set the endDate to null, and we will assume an indefinite range. endDate is exclusive, i.e. we will end billing/functionality up to but not at this particular time.
endReason string
An optional note describing the reason the auditable item was ended.
source string
Allowed values: bitcoinBuilder ftx ftx-retail ftx-bahamas ftx-bahamas-retail sofi sofiDocuSignPendingDeprecation bitcoinWell lucid wlf walrus mtgox landingPageReferral caas test
totalWalletsCount number
The total number of wallets in the enterprise
Example: 1
internal object
migratedToNewPolicyService
boolean or null
required
Whether the enterprise has been migrated to the new policy service
policiesLocked boolean required
umsMappingComplete
boolean or null
required
distributedCustody object
signingBitgoOrg string
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1 BitGo Inc
migratedToNewPolicyService boolean
Whether the enterprise has been migrated to the new policy service
videoIdUsers array[object]
IDs of users on the enterprise that are approved for custodial video ID
email string required
The email of the user
Min length: >= 1 characters
userId string required
The user ID
Min length: >= 1 characters
inviter string required
The inviter of the user
Min length: >= 1 characters
state string required
The state of the user
Allowed values: awaitingApproval awaitingAcceptance pendingSchedule pendingInitialId underReview approved rejected archived
videoCallId string
The user's video call ID
approvalDate string
The date the user was approved
archivedDate string
The date the user was archived
pendingApprovalId string
The ID if the user is pending approval
videoLink string
The user's video link
enterpriseId string
EnterpriseId of enterprise this video users belongs to
enterpriseName string
EnterpriseName of enterprise this video users belongs to
sourceConfig array[object]
Array to store configs, upon which certain actions are taken, per source
source string required
Allowed values: bitcoinBuilder ftx ftx-retail ftx-bahamas ftx-bahamas-retail sofi sofiDocuSignPendingDeprecation bitcoinWell lucid wlf walrus mtgox landingPageReferral caas test
metadata object
The following fields: source, showBanner, readyForDistribution, showVideoIdBanner, ftxCreditorId were added for FTX insitutional distribution. Reference: https://bitgoinc.atlassian.net/browse/COPS-2695
videoIdRequired boolean
Check for video ID Users
contract object
Contract information
startDateOne of
endDateOne of
isExternal boolean
referralCode string
Referral code
oauthSettingOne of
oauth setting of the enterprise *
oauthProvider string required
Allowed value: msEntra
tenantId string required
clientId string required
clientSecret string required
optOutOfPoints boolean
Opt Out of Points System Flag
requestedBitgoOrg string
Requested BitGo Org
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland BitGo Europe ApS Frankfurt DE Trust BitGo Singapore BitGo Korea BitGo Custody MENA FZE BitGo India BitGo Sister Trust 1 BitGo Inc
requestedProducts array[string]
Requested Products
Allowed values: BitGo MMI BitGo Qualified Custody BitGo Qualified Custody & Hot Wallet Borrowing Borrowing / Lending Lending NFTs Self Custody Go Network: Off Exchange Settlement Staking Trade Transactional / Hot Wallet Wrapped Asset Services Escrow Escrow - Triparty Distributed Custody Wallet Token Management (HZ) Platform Integration (B2B2C) BitGo Wealth Management (HZ) BitGo Concierge Coincover Referral Go Network: Fiat currency Settlement Fiat Currency Custody Excess Insurance Setup Lightning Liquidity Provider Alliance Agreement BitGo Custody BitGo MMI (Inc) Coincover Referral (Inc) Custom Project NFTs (Inc) Other (Inc) Partial Signature Portfolio & Tax Professional Services Setup (Inc) Staking (Inc) Platform Integration (B2B2C) (Inc) OTC Trading
requestedBitgoProducts array[string]
Requested BitGo Products
Allowed values: Instant Fee Wallets Go Account Settlement Tax Trade API Margin Trading Elliptic CryptoCompare MetaMask Custody Borrowing Lending DeFi Cold Self-Custody Go Network Staking Trade Hot Self-Custody Escrow Escrow - Triparty Distributed Custody Advanced Wallets Stablecoins Loans against Go Account ACH Debits Go Lightning
isContractedClient boolean
True, if the enterprise has been onboarded by Salesforce

400 Response

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

500 Response

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