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": "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",
  "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 one workspace by ID, including its computers under desktops. Owners and invited members both have read access. A workspace-scoped API key can read only the workspace it is scoped to. Any other ID returns 403. See Authentication.

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.

string

Your role in the workspace: owner, admin (can edit), or member (view only).

object

What your role allows, as three booleans: canView, canWrite, and canManageAccess. Only the owner has canManageAccess.

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. 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",
  "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 }
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
      "name": "agent-2",
      "os": "linux",
      "ram": 8,
      "cpu": 2,
      "status": "stopped",
      "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.
`403`	`{ "error": "You do not have access to this workspace." }`	Your account neither owns nor belongs to the workspace, or no workspace has that ID. An unknown ID returns this `403`, not `404`.
`403`	`{ "error": "This API key cannot access this workspace (workspace_scope_mismatch)." }`	A workspace-scoped key requested a different workspace.
`500`	`{ "error": "<message>" }`	Unexpected server error.
`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.

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>

owner_tier

string

Subscription tier of the workspace owner. It sets the hardware ceiling for every computer in the workspace.

Example:

"hacker"

owner_email

string

Email address of the workspace owner. Returned to every member.

role

enum<string>

Your role in the workspace: owner, admin (can edit), or member (view only).

Available options:

owner,

admin,

member

permissions

object

What your role in the workspace allows.

Show child attributes

member_count

integer

People with access to the workspace, counting the owner. Returned by GET /workspaces only.

desktops

object[]

Computers in the workspace, in no guaranteed order. Ephemeral computers are excluded. Each entry is the stored computer record with credential fields removed, plus permissions. Treat fields not documented here as internal.

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": "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",
  "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

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