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",
      "desktops": []
    }
  ],
  "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",
      "desktops": []
    }
  ]
}

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 creates one named <your name>'s workspace and returns it.

A workspace-scoped API key is not filtered here. It lists every workspace on the account. See Authentication for where scoping is and is not enforced.

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.

Each workspace object carries the fields listed on Get workspace, 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 full stored computer record, 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",
      "desktops": [
        {
          "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
          "name": "agent-1",
          "os": "linux",
          "ram": 4,
          "cpu": 1,
          "status": "running"
        }
      ]
    }
  ]
}

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.

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

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",
      "desktops": []
    }
  ],
  "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",
      "desktops": []
    }
  ]
}

Overview

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