Orgo - Cloud computers for AI agents

GET

workspaces

{id}

Get workspace

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

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

fetch('https://www.orgo.ai/api/workspaces/{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/workspaces/{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/workspaces/{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/workspaces/{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": "550e8400-e29b-41d4-a716-446655440000",
  "name": "production",
  "user_id": "<string>",
  "status": "active",
  "icon_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "desktops": [
    {
      "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
      "name": "agent-1",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
      "project_name": "production",
      "os": "linux",
      "ram": 4,
      "cpu": 1,
      "status": "running",
      "url": "http://198.51.100.24:8081",
      "created_at": "2023-11-07T05:31:56Z",
      "instance_id": "a3881618",
      "hostname": "www.orgo.ai",
      "connection_url": "https://www.orgo.ai/desktops/a3881618",
      "vnc_password": "a06db12a8683df96"
    }
  ]
}

Returns one workspace by ID, including its computers under desktops. Owners and invited members both have read access. A workspace-scoped API key is not restricted here. It can read any workspace on the account. See Authentication for where scoping is and is not enforced.

Path parameters

string

required

Workspace ID. Required.

Response

string

Workspace identifier.

string

Workspace name.

string

User ID of the workspace owner.

string

Workspace status. active for a normal workspace.

string

Icon URL, or null when none is set.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

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.

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.

member_count is returned by List workspaces only, not by this endpoint.

Example

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

import os
import requests

api_key = os.environ["ORGO_API_KEY"]
workspace_id = os.environ["WORKSPACE_ID"]

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

workspace = response.json()
print(f"Workspace: {workspace['name']}")
for d in workspace.get("desktops", []):
    print(f"  - {d['name']}: {d['status']}")

const apiKey = process.env.ORGO_API_KEY;
const workspaceId = process.env.WORKSPACE_ID;

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

const workspace = await response.json();
console.log(`Workspace: ${workspace.name}`);
workspace.desktops?.forEach(d => {
  console.log(`  - ${d.name}: ${d.status}`);
});

Response

{
  "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",
  "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"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "name": "agent-2",
      "os": "linux",
      "ram": 8,
      "cpu": 2,
      "status": "stopped"
    }
  ]
}

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.
`403`	`{ "error": "Access denied" }`	The workspace exists, but your account neither owns it nor belongs to it.
`404`	`{ "error": "Project not found" }`	No workspace with that ID. Returned before the access check, so an unknown ID is always `404`.
`500`	`{ "error": "<message>" }`	Unexpected server error.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Workspace ID

Response

Workspace details

string

Unique workspace identifier

Example:

"550e8400-e29b-41d4-a716-446655440000"

name

string

Workspace name

Example:

"production"

user_id

string

Owner user ID

status

enum<string>

Available options:

active,

inactive

Example:

"active"

icon_url

string | null

Icon URL for the workspace, or null when none is set.

created_at

string<date-time>

updated_at

string<date-time>

desktops

object[]

Show child attributes

Get workspace

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

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

fetch('https://www.orgo.ai/api/workspaces/{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/workspaces/{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/workspaces/{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/workspaces/{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": "550e8400-e29b-41d4-a716-446655440000",
  "name": "production",
  "user_id": "<string>",
  "status": "active",
  "icon_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "desktops": [
    {
      "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
      "name": "agent-1",
      "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
      "project_name": "production",
      "os": "linux",
      "ram": 4,
      "cpu": 1,
      "status": "running",
      "url": "http://198.51.100.24:8081",
      "created_at": "2023-11-07T05:31:56Z",
      "instance_id": "a3881618",
      "hostname": "www.orgo.ai",
      "connection_url": "https://www.orgo.ai/desktops/a3881618",
      "vnc_password": "a06db12a8683df96"
    }
  ]
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Get workspace

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