Sign in
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

state'approved' | 'rejected' | 'skipped' | 'failed' required
resolutionMemostring

Memo stored on the resolver record

videoLinkstring

URL to the video recorded for a video-approved resolution

videoApproverstring

Public ID of the user who performed the video approval

videoExceptionstring

Reason a video approval requirement was excepted

halfSignedobject

Half-signed transaction payload for multisig approval flows

isFullSignedboolean

Whether the transaction is fully signed

isSignedboolean

Whether the transaction is signed

txHexstring

Serialized signed transaction hex

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' | 'redpallas'

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

Changes