Orgo - Cloud computers for AI agents

POST

accounts

Add a client

curl --request POST \
  --url https://www.orgo.ai/api/v1/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Dental",
  "external_id": "acme-dental"
}
'

import requests

url = "https://www.orgo.ai/api/v1/accounts"

payload = {
    "name": "Acme Dental",
    "external_id": "acme-dental"
}
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({name: 'Acme Dental', external_id: 'acme-dental'})
};

fetch('https://www.orgo.ai/api/v1/accounts', 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",
  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([
    'name' => 'Acme Dental',
    'external_id' => 'acme-dental'
  ]),
  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"

	payload := strings.NewReader("{\n  \"name\": \"Acme Dental\",\n  \"external_id\": \"acme-dental\"\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Acme Dental\",\n  \"external_id\": \"acme-dental\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"name\": \"Acme Dental\",\n  \"external_id\": \"acme-dental\"\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": null,
    "monthly_ai_cap_usd": null
  },
  "usage": {
    "computers": 0,
    "ai_spend_usd_this_month": 0
  },
  "billing": null,
  "transfer": null,
  "api_key": "sk_live_…"
}

The client gets their own workspace and a key scoped to it. They never sign up to Orgo: your app uses the key on their behalf. The key is in this response only, so store it with your user. Use your account-wide API key. A client’s own key gets 403 here. See Invoicing.

Body

string

Shown in Settings. Send this, external_id, or both.

string

Your id for this client, unique among your clients. Made from name when you leave it out.

integer

The most computers they can have. No limit when left out.

number

Their AI stops at this amount each month. No limit when left out.

Response

string

The client’s key. Shown once.

Every field of Get client.

Example

curl -X POST https://www.orgo.ai/api/v1/accounts \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme Dental", "external_id": "acme-dental"}'

import os
import requests

res = requests.post(
    f"https://www.orgo.ai/api/v1/accounts",
    headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
    json={"name": "Acme Dental", "external_id": "acme-dental"},
)
print(res.json())

const res = await fetch(`https://www.orgo.ai/api/v1/accounts`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"name": "Acme Dental", "external_id": "acme-dental"}),
});
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": null,
    "monthly_ai_cap_usd": null
  },
  "usage": {
    "computers": 0,
    "ai_spend_usd_this_month": 0
  },
  "billing": null,
  "transfer": null,
  "api_key": "sk_live_…"
}

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": "Send a name, an external_id, or both." }`	Neither was sent.
`409`	`{ "error": "An account with external_id "acme-dental" already exists." }`	`code` is `ACCOUNT_EXISTS`.

Authorizations

Authorization

string

header

required

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

Body

application/json

name

string

Shown in Settings. Send this, external_id, or both.

external_id

string

Your id for this client, unique among your clients. Made from name when you leave it out.

max_computers

integer

The most computers they can have. No limit when left out.

monthly_ai_cap_usd

number

Their AI stops at this amount each month. No limit when left out.

Response

Created

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.

api_key

string

Shown once.

Add a client

curl --request POST \
  --url https://www.orgo.ai/api/v1/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Dental",
  "external_id": "acme-dental"
}
'

import requests

url = "https://www.orgo.ai/api/v1/accounts"

payload = {
    "name": "Acme Dental",
    "external_id": "acme-dental"
}
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({name: 'Acme Dental', external_id: 'acme-dental'})
};

fetch('https://www.orgo.ai/api/v1/accounts', 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",
  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([
    'name' => 'Acme Dental',
    'external_id' => 'acme-dental'
  ]),
  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"

	payload := strings.NewReader("{\n  \"name\": \"Acme Dental\",\n  \"external_id\": \"acme-dental\"\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")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Acme Dental\",\n  \"external_id\": \"acme-dental\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"name\": \"Acme Dental\",\n  \"external_id\": \"acme-dental\"\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": null,
    "monthly_ai_cap_usd": null
  },
  "usage": {
    "computers": 0,
    "ai_spend_usd_this_month": 0
  },
  "billing": null,
  "transfer": null,
  "api_key": "sk_live_…"
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Add a client

Body

Response

Example

Response

Errors

Authorizations

Body

Response

​Body

​Response

​Example

​Response

​Errors

Authorizations

Body

Response

Body

Response

Example

Response

Errors