Ctrl+K

Update enterprise

put/api/v2/enterprise/{enterpriseId}

Path Parameters

  • enterpriseIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$

Request Body

acceptCustodySAOne of
Accept the custody services agreement. Can be either: - true (boolean): Accept the agreement without specifying a BitgoOrg - BitgoOrg string: Accept the agreement and specify which BitgoOrg is signing
acceptMasterAgreementOne of
Accept the master agreement (includes trade, staking, and custody agreements). Can be either: - true (boolean): Accept the agreement without specifying a BitgoOrg - BitgoOrg string: Accept the agreement and specify which BitgoOrg is signing
legalIdentifiers object
Example: {"legalPersonName":"Pineapple Capital Inc"}
legalPersonName string required
Legal name of the Enterprise
approvalsRequired integer
How many Enterprise Admins are required for action to fire
Minimum: >= 1
distributedCustody object
Parameters associated with distributed custody enterprises. If you want to remove 'signingBitgoOrg', set it to null.
signingBitgoOrg
string or null
BitGo Organization related to this entity. Allowed values are BitGo Inc, BitGo Trust, BitGo New York, BitGo Germany, BitGo Switzerland, Frankfurt DE Trust, BitGo Sister Trust 1, BitGo Korea, BitGo Singapore, null
usersViewAllWallets boolean
Allow users to view all wallets

200 Response

accountType string
Indicates which type of KYC process the enterprise has to complete
Allowed values: individual entity
additionalEnterpriseInfo object
regulator string
regulatorId string
contact object
Example: {"name":"Jane Doe","street":"1","street2":"Wall Street","suite":"3","city":"New York","state":"NY","postalCode":"10005","country":"USA"}
admin object
policy object
approvedVideoIdUsers array[string]
IDs of users on the enterprise that are approved for custodial video ID
Example: 59cd72485007a239fb00282ed480da1f
approvalsRequired integer
How many Enterprise Admins are required for action to fire
Example: 1
bitgoEthKey string
The public portion of the ethererum key generated for the enterprise fee address
bitgoOrg string
BitGo Organization related to this entity
Allowed values: BitGo Inc BitGo Trust BitGo New York BitGo Germany BitGo Switzerland Frankfurt DE Trust BitGo Sister Trust 1 BitGo Korea BitGo Singapore BitGo Europe ApS BitGo Mena Fze BitGo Custody MENA FZE BitGo India
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
canAccessTrading boolean
whether the enterprise has the licence to access BitGo Trading
canCreateColdWallet boolean
whether the enterprise has the license to create cold wallets
canCreateCustodialWallets 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
contract object
startDate string
The contract start date for an enterprise
endDate string
The contract end date for an enterprise
custodyServicesAgreement object
Information about the signed custody services agreement
user string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
date string <date-time>required
The date when the agreement was signed
ip string
The IP address from which the agreement was signed
bitgoOrg string
The Trust entity for which the CSA was signed. Used to prevent switching custodians after signing. May be undefined for legacy agreements signed before this field was added.
Allowed values: BitGo Inc BitGo Trust BitGo New York BitGo Germany BitGo Switzerland Frankfurt DE Trust BitGo Sister Trust 1 BitGo Korea BitGo Singapore BitGo Europe ApS BitGo Mena Fze BitGo Custody MENA FZE BitGo India
emergencyPhone string
Phone number for emergencies
Example: +11234567890
ethFeeAddress string
The eth fee address used to pay for network transaction fees of this enterprise
freeze object
time string <date-time>
When the freeze started
expires string <date-time>
When the freeze will end
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
kycState string
Allowed values: unverified approved rejected
latestSAVersionSigned integer
Example: 0
licenses string
Allowed values: bitgoNetwork marginTrading mtGox portfolioAPI portfolioBasic portfolioProfessional portfolioInstitutional tax tradeAPI staking metaMaskInstitutional cryptoCompare elliptic instantFeeHotWallet bitgoTrustAsKrs escrow distributedCustodyWallet selfCustodyLightningWallet custodyLightningWallet advancedWallets
mutablePolicyWindow integer
Time in seconds after which policies on this Enterprise cannot be updated
Example: 172800
name string
Example: Small Company
pricingPlan string
The pricing plan of the enterprise
pricingTypes array[object]
name object
datesActive array[object]
activePricingType object
id string
Unique identifier for the date range.
startDate string
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
An optional note describing the reason the auditable item was added/created.
endDate string
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.
name string
Allowed values: starter growth
kits array[object]
name object
datesActive array[object]
activeKits array[object]
id string
Unique identifier for the date range.
startDate string
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
An optional note describing the reason the auditable item was added/created.
endDate string
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.
name string
Allowed values: default wallet custody liquidity cryptoCompare
primaryContact string
The Id of the User who is the primary contact
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
preferredUi string
The UI that this enterprise prefers to use
Allowed value: bg23
totalWalletsCount integer
The total number of wallets in the enterprise
Example: 1
usersViewAllWallets boolean
All users on the enterprise can view all enterprise wallets, even if they are not viewers on the wallet itself
Example: true
videoIdWaived boolean
Whether the customer has waived the need for Video ID on low risk withdrawals.
Example: true

202 Response

id string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
bitcoinAddress string
Example: 1G47mSr3oANXMafVrR8UC4pzV7FEAzo3r9
enterprise string
The Id of the associated enterprise
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
walletId string
The base address of the associated wallet
Example: 1G47mSr3oANXMafVrR8UC4pzV7FEAzo3r9
creator string
The Id of the User that created the Pending Approval
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
createDate string <date-time>
info object
type string
Allowed values: bitcoinAddressWhitelistRequest userChangeRequest policyRuleRequest dailyLimitPolicyRequest transactionRequest tagUpdateRequest updateEnterpriseRequest updateApprovalsRequiredRequest
updateEnterpriseRequest object
updateApprovalsRequiredRequest object
state string
Allowed values: pending approved rejected
walletUserIds array[string]
an array of all the Users on the Wallet who need to see this Pending Approval
Example: 59cd72485007a239fb00282ed480da1f
approvalsRequired number
Minimum: >= 1
resolvers array[object]
user string
date string
resolutionType string
Allowed values: pending approved rejected
signatures array[string]
videoApprover string
videoLink string
videoException string

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

404 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