PUT
Update enterprise
Path Params
-
enterpriseIdstring requiredThe enterprise ID
Body Params
object
-
legalIdentifiersobjectlegalIdentifiers object
-
legalPersonNamestring requiredLegal name of the Enterprise
-
-
approvalsRequiredintegerHow many Enterprise Admins are required for action to fire -
distributedCustodyobjectParameters associated with distributed custody enterprises. If you want to remove 'signingBitgoOrg', set it to null.distributedCustody object
-
signingBitgoOrgstring nullableBitGo 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
-
-
usersViewAllWalletsbooleanAllow users to view all wallets -
preferredUistring enumThe UI that this enterprise prefers to usebg23bg25-instbg25-retailkintsugi
Responses
200
OK
Response Body
object
-
accountTypestring enumIndicates which type of KYC process the enterprise has to completeindividualentity -
additionalEnterpriseInfoobjectadditionalEnterpriseInfo object
-
contactobjectcontact object
-
namestringLegal name of the enterprise, not neccessarily the enterprise name -
streetstringAddress line -
street2string nullableOptional 2nd address line -
suitestringOptional suite number -
citystringCity name -
statestringState or region -
postalCodestringPostcal code -
countrystringISO 3166-1 Alpha-3 country code
-
-
-
adminobjectadmin object
-
policyobjectpolicy object
-
idstring required -
datestring date-time -
labelstring -
latestboolean required -
rulesarray of objects requiredrules object
-
idstring required -
lockDatestring date-time requiredThe time at which this rule becomes immutable -
mutabilityConstraintstring enumSpecifies whether a BitGo admin can change
lockDatemanaged- Not locked, but requires approval from a BitGo admin to changepermanent-lockDatecannot be changed
managedpermanent -
coinstringA cryptocurrency or token ticker symbol. -
typestring enum requiredWhat causes this rule to triggeradvancedWhitelistallTxbitcoinAddressWhitelistcoinAddressWhitelistcoinAddressBlacklisttransactionLimitvelocityLimitwebhook -
conditionobjectParameters for the typeONE OF
-
amountStringstring -
timeWindowintegerTime window in seconds for a velocity limit, between 1 and a month
-
amountStringstring -
timeWindowintegerTime window in seconds for a velocity limit, between 1 and 30 days
-
addressesarray of objectsAddresses allowed/restricted for a whitelist/blacklistONE OF
string
string
-
entriesarray of objectsEntries specifying which addresses/ wallets/ enterprises are on the whitelistentries object
-
itemstring requiredA valid blockchain address, wallet ID, enterprise ID, or organization ID. Must be unique in this whitelist. -
metaDataobjectAny data about this entry that is not used to determine when to enforce the policymetaData object
-
labelstringA client-specified label for this entry. Label must be unique or not set. -
ownerstringThe legal owner of the address, wallet, enterprise, or organization. -
addressstringThe address of the receiver wallet if the whitelist is of type 'walletId'.
-
-
typestring enum requiredthe kind of resource a list rule entry refers toaddresswalletIdenterpriseIdlinkAccountId -
verificationStatestring enumA state denoting whether entries have already been verified.unverifiedverified -
verifiedBystring enumThe source that verified this entry (unverifiedRule or fastWithdrawal)unverifiedRulefastWithdrawal
-
-
urlstringthe url to query for the webhook
-
-
actionobject requiredWhat happens when this rule is triggeredaction object
-
typestring enum requireddenygetApprovalgetFinalApprovalgetCustodianApprovalgetIdVerification -
userIdsarray of stringsFor a final approver action, who can approve
-
-
-
versioninteger required
-
-
-
approvedVideoIdUsersarray of stringsIDs of users on the enterprise that are approved for custodial video ID -
approvalsRequiredintegerHow many Enterprise Admins are required for action to fire -
bitgoEthKeystringThe public portion of the ethererum key generated for the enterprise fee address -
bitgoOrgstring enumBitGo Organization related to this entityBitGo IncBitGo TrustBitGo New YorkBitGo GermanyBitGo SwitzerlandFrankfurt DE TrustBitGo Sister Trust 1BitGo KoreaBitGo SingaporeBitGo Europe ApSBitGo Mena FzeBitGo Custody MENA FZEBitGo India -
canAccessBorrowingbooleanwhether the enterprise has the licence for BitGo Prime Borrowing -
canAccessLendingbooleanwhether the enterprise has the licence for BitGo Prime Lending -
canAccessSettlementbooleanwhether the enterprise has the licence to utilize settlement functionality -
canAccessTradingbooleanwhether the enterprise has the licence to access BitGo Trading -
canCreateColdWalletbooleanwhether the enterprise has the license to create cold wallets -
canCreateCustodialWalletsbooleanwhether the enterprise has the license to create custodial wallets -
canCreateHotWalletbooleanwhether the enterprise has the license to create hot wallets -
contractobjectcontract object
-
startDatestringThe contract start date for an enterprise -
endDatestringThe contract end date for an enterprise
-
-
custodyServicesAgreementobjectInformation about the signed custody services agreementcustodyServicesAgreement object
-
userstring required -
datestring date-time requiredThe date when the agreement was signed -
ipstringThe IP address from which the agreement was signed -
bitgoOrgstring enumBitGo Organization related to this entityBitGo IncBitGo TrustBitGo New YorkBitGo GermanyBitGo SwitzerlandFrankfurt DE TrustBitGo Sister Trust 1BitGo KoreaBitGo SingaporeBitGo Europe ApSBitGo Mena FzeBitGo Custody MENA FZEBitGo India
-
-
emergencyPhonestringPhone number for emergencies -
ethFeeAddressstringThe eth fee address used to pay for network transaction fees of this enterprise -
freezeobjectfreeze object
-
timestring date-timeWhen the freeze started -
expiresstring date-timeWhen the freeze will end
-
-
idstring required -
mutablePolicyWindowintegerTime in seconds after which policies on this Enterprise cannot be updated -
namestring -
pricingTypesarray of objectspricingTypes object
-
nameobjectname object
-
namestring enumstartergrowth
-
-
datesActivearray of objectsdatesActive object
-
idstringUnique identifier for the date range. -
startDatestringISO 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. -
startReasonstringAn optional note describing the reason the auditable item was added/created. -
endDatestringISO 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. -
endReasonstringAn optional note describing the reason the auditable item was ended.
-
-
-
activePricingTypeobjectactivePricingType object
-
idstringUnique identifier for the date range. -
startDatestringISO 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. -
startReasonstringAn optional note describing the reason the auditable item was added/created. -
endDatestringISO 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. -
endReasonstringAn optional note describing the reason the auditable item was ended. -
namestring enumstartergrowth
-
-
kitsarray of objectskits object
-
nameobjectname object
-
namestring enumdefaultwalletcustodyliquiditycryptoCompare
-
-
datesActivearray of objectsdatesActive object
- Same shape as
AuditableItem.
- Same shape as
-
-
activeKitsarray of objectsactiveKits object
-
idstringUnique identifier for the date range. -
startDatestringISO 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. -
startReasonstringAn optional note describing the reason the auditable item was added/created. -
endDatestringISO 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. -
endReasonstringAn optional note describing the reason the auditable item was ended. -
namestring enumdefaultwalletcustodyliquiditycryptoCompare
-
-
primaryContactstringThe Id of the User who is the primary contact -
preferredUistring enumThe UI that this enterprise prefers to usebg23bg25-instbg25-retailkintsugi -
totalWalletsCountintegerThe total number of wallets in the enterprise -
usersViewAllWalletsbooleanAll users on the enterprise can view all enterprise wallets, even if they are not viewers on the wallet itself -
videoIdWaivedbooleanWhether the customer has waived the need for Video ID on low risk withdrawals.
202
Accepted
Response Body
object
-
idstring -
enterprisestringThe Id of the associated enterprise -
walletIdstringThe base address of the associated wallet -
creatorstringThe Id of the User that created the Pending Approval -
createDatestring date-time -
infoobjectinfo object
-
typestring enumbitcoinAddressWhitelistRequestuserChangeRequestpolicyRuleRequestdailyLimitPolicyRequesttransactionRequesttagUpdateRequestupdateEnterpriseRequestupdateApprovalsRequiredRequest -
updateEnterpriseRequestobjectupdateEnterpriseRequest object
-
actionstring enumaddremove -
permissionsarray of string enumsadmin -
userIdstringThe Id of the User to be added to or removed from the Enterprise -
emailstring emailE-Mail address of newly added users
-
-
updateApprovalsRequiredRequestobjectupdateApprovalsRequiredRequest object
-
requestedApprovalsRequirednumberthe number of approvalsRequired that should be changed to
-
-
-
statestring enumpendingapprovedrejected -
walletUserIdsarray of stringsan array of all the Users on the Wallet who need to see this Pending Approval -
approvalsRequirednumber -
resolversarray of objectsresolvers object
-
userstring -
datestring -
resolutionTypestring enumpendingapprovedrejected -
signaturesarray of strings -
videoApproverstring -
videoLinkstring -
videoExceptionstring
-
400
Bad Request
Response Body
object
-
errorstring requiredHuman-readable error message -
requestIdstring requiredClient request id -
contextobjectProperties that apply to a specific error name -
namestring requiredError code
404
Not Found
Response Body
object
-
errorstring requiredHuman-readable error message -
requestIdstring requiredClient request id -
contextobjectProperties that apply to a specific error name -
namestring requiredError code