Start a resource transfer (owner/admin)
Offers one of the org's VMs to another organization, named by targetOrgSlug, and returns the pending transfer, which can be accepted for 7 days. A VM can have one unexpired pending transfer at a time; a second returns 409, as does an inference serving replica. Naming the caller's own org returns 400. An organization under review or being verified cannot offer a VM: the offer answers 403 ACCOUNT_RESTRICTED or ACCOUNT_PENDING_VERIFICATION.
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 create --resource-id <resource-id> --resource-type <resource-type> --target-org-slug <target-org-slug>apiKeyAuthorizationBearer <token>OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).
orgId*stringapplication/json- body
resourceType*"vm""vm"resourceId*stringtargetOrgSlug*stringnote?stringCreated
application/json- response
id*stringresourceType*stringvmId?stringsourceOrganizationId*stringtargetOrganizationId*stringinitiatedBy?stringrespondedBy?stringstatus*stringnote?stringcreatedAt*stringrespondedAt?stringcompletedAt?stringexpiresAt?stringcurl -X POST 'https://api.openrelay.inc/v1/orgs/string/transfers' \ -H 'Content-Type: application/json' \ -d '{ "resourceType": "vm", "resourceId": "string", "targetOrgSlug": "string"}'{ "id": "string", "resourceType": "string", "vmId": "string", "sourceOrganizationId": "string", "targetOrganizationId": "string", "initiatedBy": "string", "respondedBy": "string", "status": "string", "note": "string", "createdAt": "string", "respondedAt": "string", "completedAt": "string", "expiresAt": "string"}List orgs you can transfer resources to GET
The organizations the caller belongs to, other than the org the request acts in, sorted by name with id, name and slug, for choosing a transfer target. Requires a signed-in user session; a request without one returns 401.
Pending incoming transfers (enriched) GET
The pending transfers addressed to the org, newest first, each with the VM's name (Deleted VM once it is gone) and the sending org's name and slug. A transfer past its 7-day expiry stays listed as pending until it is rejected or cancelled, or an accept attempt marks it expired.