Orgo - Cloud computers for AI agents

GET

workspaces

List workspaces

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

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

fetch('https://www.orgo.ai/api/workspaces', 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/workspaces",
  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/workspaces"

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

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

{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "production",
      "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
      "status": "active",
      "icon_url": null,
      "created_at": "2026-04-07T10:30:00Z",
      "updated_at": "2026-04-07T10:30:00Z",
      "member_count": 3,
      "owner_tier": "hacker",
      "owner_email": "owner@example.com",
      "role": "owner",
      "permissions": {
        "canView": true,
        "canWrite": true,
        "canManageAccess": true
      },
      "desktops": [
        {
          "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
          "name": "agent-1",
          "os": "linux",
          "ram": 4,
          "cpu": 1,
          "status": "running",
          "permissions": {
            "canView": true,
            "canWrite": true,
            "canManageAccess": true
          }
        }
      ]
    }
  ],
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "production",
      "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
      "status": "active",
      "icon_url": null,
      "created_at": "2026-04-07T10:30:00Z",
      "updated_at": "2026-04-07T10:30:00Z",
      "member_count": 3,
      "owner_tier": "hacker",
      "owner_email": "owner@example.com",
      "role": "owner",
      "permissions": {
        "canView": true,
        "canWrite": true,
        "canManageAccess": true
      },
      "desktops": [
        {
          "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
          "name": "agent-1",
          "os": "linux",
          "ram": 4,
          "cpu": 1,
          "status": "running",
          "permissions": {
            "canView": true,
            "canWrite": true,
            "canManageAccess": true
          }
        }
      ]
    }
  ]
}

Returns every workspace you own or belong to, each with its computers under desktops. Workspaces you own come first, oldest first, followed by workspaces shared with you.

This call is not read-only. If the account has no workspaces yet, the first call with an account-wide key creates one named <your name>'s workspace and returns it. The name comes from your profile name, or from the part of your email before the @ when no profile name is set.

A workspace-scoped API key sees only the workspace it is scoped to, and never triggers the default-workspace creation. See Authentication.

Response

The same array is returned under two keys.

array

Array of workspace objects, each with its desktops. Read this key.

array

The identical array. project is the API’s original name for a workspace. The key is kept for existing integrations. Do not read it in new code.

For an account on the free plan, the body can also carry a trial_snapshot object. The dashboard reads it. It is not part of the documented contract. Each workspace object carries the fields listed on Get workspace, including role and permissions, plus:

integer

People with access to the workspace, counting the owner. Returned by this endpoint only.

string

Subscription tier of the workspace owner. Computers are funded by the owner’s plan, so this is the tier that sets the hardware ceiling for every computer in the workspace, including computers created by invited members.

string

Email address of the workspace owner. Returned to every member of the workspace, not only the owner.

array

Computers in the workspace, in no guaranteed order. Ephemeral computers are excluded. Each entry is the stored computer record with credential fields removed, plus the same permissions object, so it carries more fields than the example below. Treat any field not documented here as internal and subject to change.

Example

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

import os
import requests

api_key = os.environ["ORGO_API_KEY"]

response = requests.get(
    "https://www.orgo.ai/api/workspaces",
    headers={"Authorization": f"Bearer {api_key}"}
)

workspaces = response.json()["workspaces"]
for ws in workspaces:
    n = len(ws.get("desktops") or [])
    print(f"{ws['name']}: {n} computers")

const apiKey = process.env.ORGO_API_KEY;

const response = await fetch('https://www.orgo.ai/api/workspaces', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const { workspaces } = await response.json();
workspaces.forEach(ws => {
  const n = (ws.desktops || []).length;
  console.log(`${ws.name}: ${n} computers`);
});

Response

The response repeats the same array under projects, omitted here for length.

{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "production",
      "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
      "status": "active",
      "icon_url": null,
      "created_at": "2026-04-07T10:30:00Z",
      "updated_at": "2026-04-07T10:30:00Z",
      "member_count": 3,
      "owner_tier": "hacker",
      "owner_email": "owner@example.com",
      "role": "owner",
      "permissions": { "canView": true, "canWrite": true, "canManageAccess": true },
      "desktops": [
        {
          "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
          "name": "agent-1",
          "os": "linux",
          "ram": 4,
          "cpu": 1,
          "status": "running",
          "permissions": { "canView": true, "canWrite": true, "canManageAccess": true }
        }
      ]
    }
  ]
}

Errors

Status	Body	Meaning
`401`	`{ "error": "Invalid API key" }`	The Bearer token starts with `sk_` but is not a known Orgo key.
`401`	`{ "error": "Authentication required" }`	No `Authorization` header, or a Bearer token that is not an `sk_` key.
`500`	`{ "error": "<message>" }`	The listing query failed, or the default-workspace creation failed.
`503`	`{ "error": "Service temporarily unavailable. …" }`	Orgo could not verify the credential because of a server-side fault. The response carries `Retry-After: 5`. Retry after that delay.

There is no 403 on this endpoint. It never rejects a caller who authenticated.

Authorizations

Authorization

string

header

required

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

Response

Your workspaces

workspaces

object[]

Workspaces you own or belong to, each with its computers embedded.

Show child attributes

projects

object[]

deprecated

The same array under its older name. Identical contents, element for element.

Show child attributes

trial_snapshot

object

Present for an account on the free plan. The dashboard reads it; it is not part of the documented contract.

List workspaces

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

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

fetch('https://www.orgo.ai/api/workspaces', 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/workspaces",
  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/workspaces"

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

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

{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "production",
      "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
      "status": "active",
      "icon_url": null,
      "created_at": "2026-04-07T10:30:00Z",
      "updated_at": "2026-04-07T10:30:00Z",
      "member_count": 3,
      "owner_tier": "hacker",
      "owner_email": "owner@example.com",
      "role": "owner",
      "permissions": {
        "canView": true,
        "canWrite": true,
        "canManageAccess": true
      },
      "desktops": [
        {
          "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
          "name": "agent-1",
          "os": "linux",
          "ram": 4,
          "cpu": 1,
          "status": "running",
          "permissions": {
            "canView": true,
            "canWrite": true,
            "canManageAccess": true
          }
        }
      ]
    }
  ],
  "projects": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "production",
      "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
      "status": "active",
      "icon_url": null,
      "created_at": "2026-04-07T10:30:00Z",
      "updated_at": "2026-04-07T10:30:00Z",
      "member_count": 3,
      "owner_tier": "hacker",
      "owner_email": "owner@example.com",
      "role": "owner",
      "permissions": {
        "canView": true,
        "canWrite": true,
        "canManageAccess": true
      },
      "desktops": [
        {
          "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
          "name": "agent-1",
          "os": "linux",
          "ram": 4,
          "cpu": 1,
          "status": "running",
          "permissions": {
            "canView": true,
            "canWrite": true,
            "canManageAccess": true
          }
        }
      ]
    }
  ]
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

List workspaces

Response

Example

Response

Errors

Authorizations

Response

​Response

​Example

​Response

​Errors

Authorizations

Response

Response

Example

Response

Errors