Clients
Transfer client
Hand the workspace, its computers, and its key to your client’s own Orgo account.
POST
/
v1
/
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
Body
Response
The client, withtransfer 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. |
403 | { "error": "Invoicing isn’t available on this account. Contact Orgo." } | Orgo turned invoicing off for this account. code is MANAGED_ACCOUNTS_DISABLED. |
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. |
429 | { "error": "Too many API requests this minute (600 a minute on your plan). Try again in 30 seconds.", "code": "rate_limited", "limit": "api_other_per_minute", "retry_after": 30 } | Your account’s plan rate limit for other API calls. limit is api_other_per_minute. Carries a Retry-After header with the seconds to wait. Refused before the request runs. See Plan rate limits. |
Authorizations
Response
OK
A client: a workspace you run for them, with a key scoped to it.
⌘I
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"
}
}