Cancel draft transfer

🚧

Beta feature

This feature is currently in beta testing, and the final specification may still change.

Cancels a draft transfer created via this API. Transitions the draft transfer to declined with statusReason.code set to deleted-by-creator.

Only draft transfers created via this API, and still in pending-review, can be cancelled this way. A 422 is returned if the initiator has already started approving it.

In test mode, this always returns a synthetic declined draft. See Create draft transfer for how to simulate approved and declined outcomes.

πŸ”‘

Access with

Advanced access token with business-account-draft-transfers.writeOAuth access with business-account-draft-transfers.write
Path Params
string
required
^badrt_.+$

Provide the ID of the related draft transfer.

Body Params
boolean | null

Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting testmode to true.

Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/hal+json