Orgo - Cloud computers for AI agents

POST

workspaces

Create workspace

curl --request POST \
  --url https://www.orgo.ai/api/workspaces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my-workspace",
  "icon_url": "<string>",
  "status": "active"
}
'

import requests

url = "https://www.orgo.ai/api/workspaces"

payload = {
    "name": "my-workspace",
    "icon_url": "<string>",
    "status": "active"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'my-workspace', icon_url: '<string>', status: 'active'})
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'my-workspace',
    'icon_url' => '<string>',
    'status' => 'active'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/workspaces"

	payload := strings.NewReader("{\n  \"name\": \"my-workspace\",\n  \"icon_url\": \"<string>\",\n  \"status\": \"active\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/workspaces")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"my-workspace\",\n  \"icon_url\": \"<string>\",\n  \"status\": \"active\"\n}")
  .asString();

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::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"my-workspace\",\n  \"icon_url\": \"<string>\",\n  \"status\": \"active\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-workspace",
  "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
  "status": "active",
  "icon_url": null,
  "created_at": "2026-04-07T10:30:00Z"
}

Creates a workspace and returns it with 201. The calling account becomes the owner.

Workspaces are containers for computers. Use them to separate projects, environments, or teams.

A workspace-scoped API key can call this, and it gets a new workspace it is not scoped to. Key scope is not enforced on this endpoint. See Authentication.

Request

string

required

Workspace name. Leading and trailing whitespace is trimmed. The name must not match one you already own, compared case-insensitively. Names of workspaces shared with you do not conflict. Missing, non-string, or whitespace-only values are rejected with 400.

string

Optional URL of an icon for the workspace. Stored as given and not validated. Omit it and the workspace is created with icon_url: null.

string

default:"active"

Optional. Defaults to active when omitted. The product understands active and inactive. The field is stored as given and is not validated against that list.

Response

string

Workspace identifier. Use it as workspace_id when creating computers.

string

Workspace name, trimmed.

string

User ID of the owner, which is your account.

string

Workspace status.

string

Icon URL, or null when none was sent.

string

ISO 8601 timestamp.

The create response does not include updated_at, owner_tier, owner_email, or desktops. Get workspace returns those.

Example

curl -X POST https://www.orgo.ai/api/workspaces \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production"}'

import os
import requests

api_key = os.environ["ORGO_API_KEY"]

response = requests.post(
    "https://www.orgo.ai/api/workspaces",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={"name": "production"}
)

workspace = response.json()
print(f"Created: {workspace['id']}")

const apiKey = process.env.ORGO_API_KEY;

const response = await fetch('https://www.orgo.ai/api/workspaces', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ name: 'production' })
});

const workspace = await response.json();
console.log(`Created: ${workspace.id}`);

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

Errors

Status	Body	Meaning
`400`	`{ "error": "Invalid request body" }`	The body was not valid JSON.
`400`	`{ "error": "Project name is required" }`	`name` was missing, not a string, or whitespace only.
`400`	`{ "error": "A project with this name already exists" }`	You already own a workspace with that name, compared case-insensitively.
`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": "Sign up to create your own workspace.", "code": "GUEST_RESTRICTED" }`	The caller joined through a share link. Guests can work in the workspace they were invited to but cannot create their own.
`500`	`{ "error": "Could not verify account", "code": "AUTH_LOOKUP_FAILED" }`	The account lookup that gates guests failed. Retry.
`500`	`{ "error": "<message>" }`	Unexpected server error.

Some error bodies on this endpoint carry a code alongside error. Branch on code where it is present. It is stable, and the error string is not.

Authorizations

Authorization

string

header

required

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

Body

application/json

name

string

required

Workspace name. Must be unique within your account.

Minimum string length: 1

Example:

"my-workspace"

icon_url

string

Optional icon URL

status

enum<string>

default:active

Available options:

active,

inactive

Response

Workspace created

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>

Create workspace

curl --request POST \
  --url https://www.orgo.ai/api/workspaces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my-workspace",
  "icon_url": "<string>",
  "status": "active"
}
'

import requests

url = "https://www.orgo.ai/api/workspaces"

payload = {
    "name": "my-workspace",
    "icon_url": "<string>",
    "status": "active"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'my-workspace', icon_url: '<string>', status: 'active'})
};

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 => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'my-workspace',
    'icon_url' => '<string>',
    'status' => 'active'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/workspaces"

	payload := strings.NewReader("{\n  \"name\": \"my-workspace\",\n  \"icon_url\": \"<string>\",\n  \"status\": \"active\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/workspaces")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"my-workspace\",\n  \"icon_url\": \"<string>\",\n  \"status\": \"active\"\n}")
  .asString();

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::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"my-workspace\",\n  \"icon_url\": \"<string>\",\n  \"status\": \"active\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-workspace",
  "user_id": "4d96f9a0-7727-4b63-889a-32544c206d7c",
  "status": "active",
  "icon_url": null,
  "created_at": "2026-04-07T10:30:00Z"
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Create workspace

Request

Response

Example

Response

Errors

Authorizations

Body

Response

​Request

​Response

​Example

​Response

​Errors

Authorizations

Body

Response

Request

Response

Example

Response

Errors