Request a revert

Creates a new transfer that returns the funds of a settled transfer, linked to the original. The counterparty must authorize the revert like any other transfer.

Required permission: authorize:transfer.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Used in these guides:

Path Params
string
required

Unique identifier of the settled transfer being reverted.

Body Params
string
required
length ≥ 1

Why the funds are being returned. Shared with the counterparty.

string

Address the funds should be returned to (bare, CAIP-10 or did:pkh) on the original transfer's chain. Defaults to the original transfer's source address.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

429

Too Many Requests: more than 6,000 calls in 300 seconds. Every endpoint refuses your calls for the next 10 seconds. Send the request again with a backoff, as Rate limiting explains.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json