Orgo - Cloud computers for AI agents

GET

accounts

List clients

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

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

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 => "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"

	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")

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

{
  "accounts": [
    {
      "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
    }
  ],
  "next": null,
  "total": 1,
  "collecting": {
    "clients": 1,
    "usd_per_month": 250
  }
}

Returns active clients unless you ask for closed ones. The total counts every match, not just this page, and collecting sums what paying clients send you each month. Use your account-wide API key. A client’s own key gets 403 here. See Invoicing.

Query parameters

string

Matches name or external_id.

string

closed lists closed clients. Anything else lists active ones.

integer

Up to 200. Defaults to 50.

string

The next value from the previous page.

Response

array

Clients, newest first. See Get client for each field.

string

Pass as before for the next page, or null on the last one.

integer

Clients matching the filters, across every page.

object

clients paying you, and usd_per_month they pay in all.

Example

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

import os
import requests

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

const res = await fetch(`https://www.orgo.ai/api/v1/accounts`, {
  headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}` },
});
console.log(await res.json());

Response

{
  "accounts": [
    {
      "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
    }
  ],
  "next": null,
  "total": 1,
  "collecting": {
    "clients": 1,
    "usd_per_month": 250
  }
}

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`.

Authorizations

Authorization

string

header

required

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

Query Parameters

string

Matches name or external_id.

status

string

closed lists closed clients. Anything else lists active ones.

limit

integer

Up to 200. Defaults to 50.

before

string

The next value from the previous page.

Response

accounts

object[]

Show child attributes

string | null

total

integer

collecting

object

Show child attributes

List clients

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

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

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 => "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"

	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")

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

{
  "accounts": [
    {
      "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
    }
  ],
  "next": null,
  "total": 1,
  "collecting": {
    "clients": 1,
    "usd_per_month": 250
  }
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

List clients

Query parameters

Response

Example

Response

Errors

Authorizations

Query Parameters

Response

​Query parameters

​Response

​Example

​Response

​Errors

Authorizations

Query Parameters

Response

Query parameters

Response

Example

Response

Errors