Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Skip to Content
API ReferenceAccount and accessTransfers

Reject an incoming transfer (owner/admin)

Declines a pending transfer addressed to the caller's org and marks it rejected; the VM stays with the org that offered it. Returns 204 with no body.

Required permission

Requires the transfer.manage permission. See Permissions for the roles and API key permissions that include it.

Command line

The orl CLI wraps this endpoint:

orl transfers reject <id>
POST
/v1/transfers/{id}/reject

Authorization

apiKey
headerAuthorizationBearer <token>

OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).

Path Parameters

id*string

Response Body

Rejected

Example Request
curl -X POST 'https://api.openrelay.inc/v1/transfers/string/reject'
Example Response
Empty