POST
Retry a stalled transfer
Re-submit a transfer that stalled with status: "failed_retriable" or
status: "pending_otp" (the venue is waiting for a TOTP code — supply it
via venueOtp). Returns 404 TransferNotFound if the transfer is unknown or the
caller lacks link.account.transfer on its account, and 409 TransferNotRetriable
when the transfer is in any other status.
Path Params
-
enterpriseIdstring requiredYour enterprise id. -
accountIdstring requiredThe source Link account id. -
transferIdstring requiredThe transfer id to retry.
Header Params
-
user-idstring requiredUser id of the user making the request.
Body Params
object
Retry request body. All fields are optional.
-
venueOtpstringVenue-specific one-time password (TOTP code). Required forfailed_retriable/pending_otptransfers with reason.code of 'OtpRequired' or 'OtpInvalid'.
Responses
200
OK
Response Body
object
Single transfer response object
-
idstring required -
accountIdstring required -
statusstring enum requiredpending_policy_evaluationprocessingpending_approvalpendingcompletedfailedfailed_retriablepending_otpcanceledrejected -
amountstring required -
genericAssetstring -
rawAssetstring required -
displayAssetstring required -
rawNetworkstring -
fromAssetstring -
fromNetworkstring -
fromIdstring -
fromTypestring enumaddressbitgo_walletlink_accountvenue_account -
toAssetstring -
toNetworkstring -
toIdstring -
toTypestring enumaddressbitgo_walletlink_accountvenue_account -
toMemostringDestination memo / destination tag for this transfer, stored verbatim at initiation: an explicitdestination.memo, or the?dt=-style suffix parsed offtoAddress(toIdkeeps the raw address with the suffix). Absent for chains without memos and for transfers that predate memo capture. -
initiatedBystring -
fromNamestring -
toNamestring -
fromVenueIdstring -
toVenueIdstring -
accountSubTypestringNormalized sub-account-type for the transfer's owning Link account. Absent when a sub-type could not be determined. For pass-through values (no matching venue configuration), this carries the raw venue label andrawAccountSubType/accountSubTypeLabelare absent. -
rawAccountSubTypestringVenue-raw sub-type label, projected from venue config. Absent for pass-through values. -
accountSubTypeLabelstringHuman-readable sub-type display label, projected from venue config. Absent for single-sub-type venues or pass-through values. -
fromAccountSubTypestringSource-leg normalized sub-account-type. Only set forlink_accountlegs that ingested with a sub-type. -
fromRawAccountSubTypestring -
fromAccountSubTypeLabelstring -
toAccountSubTypestringDestination-leg normalized sub-account-type. Only set forlink_accountlegs that ingested with a sub-type. -
toRawAccountSubTypestring -
toAccountSubTypeLabelstring -
cryptoDetailobjectCrypto detail response for a transfercryptoDetail object
-
confirmationsnumber -
createdAtstring date-time required -
feeAmountstring -
feeAssetstring -
feeNetworkstring -
feeRawAssetstring -
feeRawNetworkstring -
fromAddressstring -
hashstring required -
idstring required -
linkTransferIdstring required -
statusstring enum requiredunconfirmedconfirmedfailedcanceledunknown -
toAddressstring -
toMemostringDestination memo / destination tag captured for this crypto leg: an explicitdestination.memo, or the?dt=-style suffix parsed offtoAddress. Absent for chains without memos or when the leg carries none. -
updatedAtstring date-time required
-
-
bitgoDetailobjectBitGo detail response for a transferbitgoDetail object
-
bitgoWalletAddressstring -
createdAtstring date-time required -
evaluationIdstring -
idstring required -
linkTransferIdstring required -
pendingApprovalIdstring -
transactionRequestIdstring -
transferIdstring -
updatedAtstring date-time required -
walletIdstring
-
-
venueDetailobjectVenue detail response for a transfervenueDetail object
-
createdAtstring date-time required -
idstring required -
linkTransferIdstring required -
updatedAtstring date-time required -
venueCreatedDatestring date-time required -
venueModifiedDatestring date-time required -
venueTransactionIdstring -
venueTransferIdstring
-
-
reasonobjectNormalized failure context. Set whenstatusisfailed(terminal),failed_retriable(the venue rejected this attempt but the same transfer can be retried under the sameexternalIdonce external state changes), orpending_otp(the venue requires a TOTP code the user must supply; call the retry endpoint withvenueOtpto proceed).codeis a stable string the caller can branch on;messageis a human-readable description from the venue.reason object
-
codestring required -
messagestring required
-
-
notesstring -
sortTimestampstring date-time -
createdAtstring date-time required -
updatedAtstring date-time required
400
Bad Request
No response body
401
Unauthorized
Response Body
object
Standard structured error response payload for Link API v1 error responses.
Contains an error name and human-readable error message.
-
errorNamestring required -
errorstring required
403
Forbidden
Response Body
object
Standard structured error response payload for Link API v1 error responses.
Contains an error name and human-readable error message.
-
errorNamestring required -
errorstring required
404
Not Found
Response Body
object
Standard structured error response payload for Link API v1 error responses.
Contains an error name and human-readable error message.
-
errorNamestring required -
errorstring required
409
Conflict
Response Body
object
Standard structured error response payload for Link API v1 error responses.
Contains an error name and human-readable error message.
-
errorNamestring required -
errorstring required
422
Unprocessable Entity
Response Body
object
Standard structured error response payload for Link API v1 error responses.
Contains an error name and human-readable error message.
-
errorNamestring required -
errorstring required
451
Unavailable For Legal Reasons
Response Body
object
Standard structured error response payload for Link API v1 error responses.
Contains an error name and human-readable error message.
-
errorNamestring required -
errorstring required
500
Internal Server Error
Response Body
object
Standard structured error response payload for Link API v1 error responses.
Contains an error name and human-readable error message.
-
errorNamestring required -
errorstring required