Orgo - Cloud computers for AI agents

GET

accounts

{id}

Get client

curl --request GET \
  --url https://www.orgo.ai/api/v1/accounts/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/v1/accounts/{id}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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": null,
  "computers": [
    {
      "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
      "name": "agent-1",
      "status": "running",
      "os": "linux",
      "cpu": 2,
      "ram": 8,
      "disk_size_gb": 40
    }
  ]
}

One client, with this month’s usage, who pays, and their computers. Use your account-wide API key. A client’s own key gets 403 here. See Invoicing.

Path parameters

string

required

The client’s id.

Response

string

The client’s id.

string

Your id for them.

string

Their name, or null.

string

active, closed, or transferred (they own it now).

string

Their workspace. Use it with any workspace or computer endpoint.

object

max_computers and monthly_ai_cap_usd. null is no limit.

object

computers they have and ai_spend_usd_this_month.

object

status, price_usd, and email while they pay you, or null while you pay.

object

email and sent_at while a transfer waits to be accepted, or null.

array

Their computers, newest first: id, name, status, os, cpu, ram, disk_size_gb.

string

ISO 8601 timestamp.

string

When it was closed, or null.

Example

curl https://www.orgo.ai/api/v1/accounts/$CLIENT_ID \
  -H "Authorization: Bearer $ORGO_API_KEY"

import os
import requests

client_id = os.environ["CLIENT_ID"]

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

const clientId = process.env.CLIENT_ID;

const res = await fetch(`https://www.orgo.ai/api/v1/accounts/${clientId}`, {
  headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}` },
});
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": null,
  "computers": [
    {
      "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
      "name": "agent-1",
      "status": "running",
      "os": "linux",
      "cpu": 2,
      "ram": 8,
      "disk_size_gb": 40
    }
  ]
}

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`.
`404`	`{ "error": "Account not found." }`	No client with this id is yours.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

The client’s id.

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.

Get client

curl --request GET \
  --url https://www.orgo.ai/api/v1/accounts/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.orgo.ai/api/v1/accounts/{id}', 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}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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": null,
  "computers": [
    {
      "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
      "name": "agent-1",
      "status": "running",
      "os": "linux",
      "cpu": 2,
      "ram": 8,
      "disk_size_gb": 40
    }
  ]
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Get client

Path parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Response

​Path parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Response

Path parameters

Response

Example

Response

Errors