Sign in
latestOpenAPI 3.0.32026-08-224982,0272.8 MB

e445c15e5bee

Pending approval

Update pending approval

Updates the state of a pending approval to approved or rejected. You can manage pending approvals programmatically by API or with the BitGo web UI. Ensure your authentication token has the proper scope. When creating an access token in the web UI, check the permission, "Update Pending Approvals" (under "Account Settings" > "Developer Options" > "Access Tokens").

BitGo recommends that you create a webhook policy so that you can automate approving and rejecting transactions.

put/api/v2/pendingapprovals/{approvalId}

Path parameters

approvalIdstring required
Example:59cd72485007a239fb00282ed480da1f

The pending approval ID

Request body

otpstring

Second factor authentication token

statestring required

Pending approval state to apply (e.g. approved or rejected)

Response

OK

idstring required
coinstring

A cryptocurrency or token ticker symbol.

walletstring
walletTypestring
walletSubTypestring

The subtype of the wallet (e.g., custodialHot)

walletsstring[]
enterprisestring
organizationstring
safeIdstring

The safe the pending approval is scoped to

organizationNamestring

The organization name

bitgoOrgstring

The BitGo organization

creatorstring required
createDatestring date-time required

The creation date of the pending approval

approvedDatestring date-time

The date when the approval was granted

updatedAtstring date-time

The date when the approval was last updated (any update, not just processing)

keyCurve'secp256k1' | 'ed25519' | 'bls12_381'

The key curve of the coin attached to this pending approval

scope'enterprise' | 'wallet' | 'organization' | 'global' | 'safe' required

What kind of entity the Pending Approval is tied to

userIdsstring[]
approvalsRequirednumber
walletLabelstring

Label for the wallet

approversstring[]
txRequestIdstring uuid

Transaction request ID

versionnumber

Version of the pending approval

policyEvaluationIdstring

ID for the policy evaluation

useLegacyPolicyEngineboolean

Flag to use legacy policy engine

videoCallIdstring

ID for the video call

lastUpdatedstring date-time

The last date the approval was processing