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

Accept an incoming transfer (owner/admin)

Moves the offered VM to the caller's org and marks the transfer completed. At least one sshKeyIds entry is required; those keys replace the source org's. The source org's GitHub runner config for the VM is deleted, the LLM keys it holds for the VM are revoked, and any other pending transfer of the VM is cancelled. An expired transfer returns 400. If the VM has since moved to a third org, the transfer is cancelled and the call returns 409. The accepting organization takes the VM on as a new workload: one under review, being verified, or whose available balance is under the minimum answers 403 ACCOUNT_RESTRICTED, ACCOUNT_PENDING_VERIFICATION or INSUFFICIENT_BALANCE. One with no price for the VM's or pod's shape answers 400 INVALID_RESOURCE_SIZE, POD_ADMISSION_FAILED or TIER_NOT_PRICED, and nothing moves. When the sending organization can no longer hand the VM over, the call answers 409 TRANSFER_UNAVAILABLE. When either organization's account changes while the accept runs, it answers 409 TRANSFER_ACCOUNT_CHANGED; try again. When the VM changes while the accept runs, it answers 409 CONFLICT; try again. Each of these leaves the transfer pending, so it can still be rejected, or accepted later.

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 accept <id>
POST
/v1/transfers/{id}/accept

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

id*string

Request Body

application/json
  1. body
sshKeyIds?array<string>

SSH key ids of the ACCEPTING org, which replace the source org's on the transferred VM. Required whenever the VM still exists: at least one id, each naming a live key of the accepting org.

Items1 <= items <= 64

Response Body

Accepted

Example Request
curl -X POST 'https://api.openrelay.inc/v1/transfers/string/accept' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
Empty