Orgo - Cloud computers for AI agents

PATCH

computers

{id}

move

Move computer to another workspace

curl --request PATCH \
  --url https://www.orgo.ai/api/computers/{id}/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000"
}
'

import requests

url = "https://www.orgo.ai/api/computers/{id}/move"

payload = { "workspace_id": "550e8400-e29b-41d4-a716-446655440000" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({workspace_id: '550e8400-e29b-41d4-a716-446655440000'})
};

fetch('https://www.orgo.ai/api/computers/{id}/move', 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/computers/{id}/move",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'workspace_id' => '550e8400-e29b-41d4-a716-446655440000'
  ]),
  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/computers/{id}/move"

	payload := strings.NewReader("{\n  \"workspace_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://www.orgo.ai/api/computers/{id}/move")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"workspace_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/move")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"workspace_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}"

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

{
  "success": true,
  "workspace_id": "550e8400-e29b-41d4-a716-446655440099",
  "project_id": "550e8400-e29b-41d4-a716-446655440099"
}

Moves a computer to a different workspace. The computer keeps its state, configuration, and IDs. Only its parent workspace changes. You must own both the source and the destination workspace. Being a member of either is not enough. A workspace-scoped API key can never move a computer, because a move always crosses a workspace boundary.

Path parameters

string

required

Computer UUID or instance_id. Both resolve to the same computer.

Body parameters

Send the destination workspace under workspace_id.

string

required

ID of the destination workspace. Must be owned by the same user, and must differ from the computer’s current workspace.

A request with no workspace_id returns 400. The older name project_id is also accepted; workspace_id wins when you send both.

Response

boolean

true when the move succeeded.

string

The destination workspace ID, echoed back.

string

The same destination workspace ID under its legacy name, for older clients.

Example

curl -X PATCH https://www.orgo.ai/api/computers/$COMPUTER_ID/move \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspace_id": "'"$WORKSPACE_ID"'"}'

import requests

response = requests.patch(
    f"https://www.orgo.ai/api/computers/{computer_id}/move",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={"workspace_id": target_workspace_id}
)
print(response.json())

const response = await fetch(`https://www.orgo.ai/api/computers/${computerId}/move`, {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ workspace_id: targetWorkspaceId })
});

console.log(await response.json());

Response

{
  "success": true,
  "workspace_id": "550e8400-e29b-41d4-a716-446655440099",
  "project_id": "550e8400-e29b-41d4-a716-446655440099"
}

Errors

Status	Body	When
`400`	`{ "error": "workspace_id is required" }`	`workspace_id` is missing or empty.
`400`	`{ "error": "Already in this workspace" }`	The computer already belongs to the destination workspace.
`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.
`401`	`{ "error": "You do not have access to this workspace." }`	You are not a member of the source or the destination workspace, or the destination does not exist.
`401`	`{ "error": "This workspace is view-only. Ask the owner for write access (workspace_read_only)." }`	You are a view-only member of the source or the destination workspace.
`401`	`{ "error": "This API key cannot access this workspace (workspace_scope_mismatch)." }`	The API key is scoped to a single workspace. A move always crosses a workspace boundary, so a scoped key can never perform one.
`401`	`{ "error": "Service temporarily unavailable. The database is not accepting requests. Retry shortly." }`	The credential store is unavailable. Retry; your key is not the problem.
`403`	`{ "error": "Access denied" }`	You can edit both workspaces but do not own both of them.
`404`	`{ "error": "Computer not found" }`	No computer matches the id.
`409`	`{ "error": "computer_busy" }`	Another operation holds the computer. Retry shortly.
`409`	`{ "error": "openclaw_enrollment_cleanup_required", "detail": "…" }`	The computer has an OpenClaw enrollment that the move would strand. Revoke and retire it first.
`409`	`{ "error": "latitude_monitoring_active", "detail": "Turn off Latitude monitoring for this computer first." }`	Latitude monitoring is on for this computer, or one of its monitoring jobs is still running.
`409`	`{ "error": "pool_mac_release_required", "message": "This Mac is managed by Orgo. Ask support to release it." }`	The computer is a Mac managed by Orgo.
`500`	`{ "error": "Failed to move computer" }`	The update failed, or the request body is not valid JSON.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer ID

Body

application/json

The destination workspace.

workspace_id

string

required

Destination workspace ID. Must be a workspace you own, and must differ from the computer's current workspace.

Example:

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

Response

Computer moved

success

boolean

Example:

true

workspace_id

string

The workspace the computer now belongs to.

Example:

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

project_id

string

The same destination workspace ID under its legacy name.

Move computer to another workspace

curl --request PATCH \
  --url https://www.orgo.ai/api/computers/{id}/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000"
}
'

import requests

url = "https://www.orgo.ai/api/computers/{id}/move"

payload = { "workspace_id": "550e8400-e29b-41d4-a716-446655440000" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({workspace_id: '550e8400-e29b-41d4-a716-446655440000'})
};

fetch('https://www.orgo.ai/api/computers/{id}/move', 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/computers/{id}/move",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'workspace_id' => '550e8400-e29b-41d4-a716-446655440000'
  ]),
  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/computers/{id}/move"

	payload := strings.NewReader("{\n  \"workspace_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://www.orgo.ai/api/computers/{id}/move")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"workspace_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/move")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"workspace_id\": \"550e8400-e29b-41d4-a716-446655440000\"\n}"

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

{
  "success": true,
  "workspace_id": "550e8400-e29b-41d4-a716-446655440099",
  "project_id": "550e8400-e29b-41d4-a716-446655440099"
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Move computer

Path parameters

Body parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Body

Response

​Path parameters

​Body parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Body

Response

Path parameters

Body parameters

Response

Example

Response

Errors