v1Resources/Connections/deleteCancel a connect link

Cancel a connect link

Cancels a connect link that hasn't completed, so it can no longer be used. Cancelling a link that is already canceled succeeds. A link that already completed returns 400.

delete/api/v1/connections/connect-links/{id}
connections:write
Query parameters
idstringrequired
The connect link's id, from the create response.
Response
dataobjectoptional
idstringoptional
The link's id. Use it to check the status or cancel the link.
platformstringoptional
The network the link connects.
clientIdstringoptional
The client the link is for.
statusstring (pending | started | completed | abandoned | cancelled | expired)optional
Where the link stands: pending (not opened yet), started (opened, waiting for the person to finish), completed (the account is connected), abandoned (opened but not finished within an hour), cancelled, or expired (not opened before expiresAt).
expiresAtstringoptional
When the link stops working if no one has opened it.
startedAtstringoptional
When the link was opened, or null if it hasn't been.
connectionIdstringoptional
The connection the link produced, once completed. Null until then.
reconnectConnectionIdstringoptional
The connection being reconnected, when the link was created to reconnect one. Only the create response returns it; status lookups return null.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
delete/api/v1/connections/connect-links/{id}
Your API key
id *
{}

Guides that use this resource