Orgo - Cloud computers for AI agents

POST

accounts

{id}

transfer

Transfer a client

curl --request POST \
  --url https://www.orgo.ai/api/v1/accounts/{id}/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "it@acme.com"
}
'

import requests

url = "https://www.orgo.ai/api/v1/accounts/{id}/transfer"

payload = { "email": "it@acme.com" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'it@acme.com'})
};

fetch('https://www.orgo.ai/api/v1/accounts/{id}/transfer', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/v1/accounts/{id}/transfer",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'it@acme.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/v1/accounts/{id}/transfer"

	payload := strings.NewReader("{\n  \"email\": \"it@acme.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/v1/accounts/{id}/transfer")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"it@acme.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/v1/accounts/{id}/transfer")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"it@acme.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "8f14e45f-ceea-467a-9575-6f1c2b3d4e5f",
  "external_id": "acme-dental",
  "name": "Acme Dental",
  "status": "active",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-10-01T09:00:00Z",
  "closed_at": null,
  "limits": {
    "max_computers": 3,
    "monthly_ai_cap_usd": 40
  },
  "usage": {
    "computers": 2,
    "ai_spend_usd_this_month": 12.4
  },
  "billing": {
    "status": "active",
    "price_usd": 250,
    "email": "billing@acme.com"
  },
  "transfer": {
    "email": "it@acme.com",
    "sent_at": "2026-10-20T15:00:00Z"
  }
}

Emails your client a link from your name. Once they accept it, signed in to their own Orgo account (or a new one), the workspace, its computers, and its key are theirs, on their plan and AI credits. Whatever you built on the key keeps working. You stay on as an admin until they remove you, and any billing through you ends. The link works for 14 days. Sending again replaces it. If their plan can’t run the computers yet, they pick one before accepting. Use your account-wide API key. A client’s own key gets 403 here. See Invoicing.

Path parameters

string

required

The client’s id.

Body

string

required

Your client’s email. They accept signed in with it.

Response

The client, with transfer set. After they accept, its status is transferred.

Example

curl -X POST https://www.orgo.ai/api/v1/accounts/$CLIENT_ID/transfer \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "it@acme.com"}'

import os
import requests

client_id = os.environ["CLIENT_ID"]

res = requests.post(
    f"https://www.orgo.ai/api/v1/accounts/{client_id}/transfer",
    headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
    json={"email": "it@acme.com"},
)
print(res.json())

const clientId = process.env.CLIENT_ID;

const res = await fetch(`https://www.orgo.ai/api/v1/accounts/${clientId}/transfer`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"email": "it@acme.com"}),
});
console.log(await res.json());

Response

{
  "id": "8f14e45f-ceea-467a-9575-6f1c2b3d4e5f",
  "external_id": "acme-dental",
  "name": "Acme Dental",
  "status": "active",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-10-01T09:00:00Z",
  "closed_at": null,
  "limits": {
    "max_computers": 3,
    "monthly_ai_cap_usd": 40
  },
  "usage": {
    "computers": 2,
    "ai_spend_usd_this_month": 12.4
  },
  "billing": {
    "status": "active",
    "price_usd": 250,
    "email": "billing@acme.com"
  },
  "transfer": {
    "email": "it@acme.com",
    "sent_at": "2026-10-20T15:00:00Z"
  }
}

Errors

Status	Body	Meaning
`401`	`{ "error": "Invalid API key" }`	No key, or not one of yours.
`403`	`{ "error": "Use your account-wide API key to manage accounts. Workspace keys can’t." }`	A client’s own key, or any key scoped to one workspace.
`403`	`{ "error": "Invoicing is on every paid plan. Upgrade to use it." }`	You’re on the Free plan. `code` is `UPGRADE_REQUIRED`.
`400`	`{ "error": "Enter your client’s email." }`	Missing or not an email.
`400`	`{ "error": "Send it to your client’s email, not yours." }`	It went to your own email.
`404`	`{ "error": "Account not found." }`	No client with this id is yours.
`409`	`{ "error": "This account is closed." }`	The client is closed. `code` is `ACCOUNT_CLOSED`.
`409`	`{ "error": "This account was transferred to your client." }`	The client accepted a transfer and owns it now. `code` is `ACCOUNT_TRANSFERRED`.

Authorizations

Authorization

string

header

required

API key authentication. Get your key at orgo.ai/workspaces

Path Parameters

string

required

The client’s id.

Body

application/json

string

required

Your client’s email. They accept signed in with it.

Response

A client: a workspace you run for them, with a key scoped to it.

string

external_id

string

name

string | null

status

enum<string>

Available options:

active,

closed,

transferred

workspace_id

string

created_at

string<date-time>

closed_at

string<date-time> | null

limits

object

Show child attributes

usage

object

Show child attributes

billing

object | null

Show child attributes

transfer

object | null

Show child attributes

computers

object[]

On Get client only.

Transfer a client

curl --request POST \
  --url https://www.orgo.ai/api/v1/accounts/{id}/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "it@acme.com"
}
'

import requests

url = "https://www.orgo.ai/api/v1/accounts/{id}/transfer"

payload = { "email": "it@acme.com" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({email: 'it@acme.com'})
};

fetch('https://www.orgo.ai/api/v1/accounts/{id}/transfer', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.orgo.ai/api/v1/accounts/{id}/transfer",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'it@acme.com'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/v1/accounts/{id}/transfer"

	payload := strings.NewReader("{\n  \"email\": \"it@acme.com\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/v1/accounts/{id}/transfer")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"it@acme.com\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/v1/accounts/{id}/transfer")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"it@acme.com\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "8f14e45f-ceea-467a-9575-6f1c2b3d4e5f",
  "external_id": "acme-dental",
  "name": "Acme Dental",
  "status": "active",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2026-10-01T09:00:00Z",
  "closed_at": null,
  "limits": {
    "max_computers": 3,
    "monthly_ai_cap_usd": 40
  },
  "usage": {
    "computers": 2,
    "ai_spend_usd_this_month": 12.4
  },
  "billing": {
    "status": "active",
    "price_usd": 250,
    "email": "billing@acme.com"
  },
  "transfer": {
    "email": "it@acme.com",
    "sent_at": "2026-10-20T15:00:00Z"
  }
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Transfer a client

Path parameters

Body

Response

Example

Response

Errors

Authorizations

Path Parameters

Body

Response

​Path parameters

​Body

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Body

Response

Path parameters

Body

Response

Example

Response

Errors