Orgo - Cloud computers for AI agents

POST

computers

{id}

clone

Clone computer

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/clone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

import requests

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

payload = { "name": "<string>" }
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: '<string>'})
};

fetch('https://www.orgo.ai/api/computers/{id}/clone', 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}/clone",
  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' => '<string>'
  ]),
  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}/clone"

	payload := strings.NewReader("{\n  \"name\": \"<string>\"\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/computers/{id}/clone")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"<string>\"\n}"

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

{
  "id": "b4cc290f-9bf9-3888-9912-ace4e6543003",
  "name": "agent-1 (clone)",
  "status": "running",
  "fly_instance_id": "b4cc290f"
}

Creates a copy of an existing computer with the same disk state, using your optional name, or a generated (clone) suffix. The clone lands in the source’s workspace and comes up running.

Cloning copies the full disk: installed software, files, browser sessions. The clone gets a new UUID and a new instance_id. Its auto-stop is forced to always-on regardless of the source’s setting.

Clone or fork?

	Clone	Fork
Copies	The disk: files, installed apps, browser sessions	The disk and live memory: open apps, windows, running processes
The copy starts	From a fresh boot	Where the source was
Source	Running or stopped	Running, Linux only
Name	Your `name`, or `agent-1 (clone)`	`agent-1 (fork)`

Clone a computer to reuse its setup. Fork it to try two next steps from the same moment.

Path parameters

string

required

The source computer’s UUID or instance_id. Both resolve to the same computer, as on the other computer endpoints. The instance_id is the value POST /computers returns as instance_id, and GET /computers/{id} as fly_instance_id.

Response

Returns 201 with the clone’s identifiers.

string

New computer UUID.

string

Your requested name, or a generated name such as agent-1 (clone) or agent-1 (clone 2).

string

Always running: the response is sent after the clone has booted.

string

The clone’s instance_id. This is the handle to use for its own clone, connection, and proxy calls.

Plan limits

A clone is a new computer, so it is charged against the workspace owner’s plan. It draws on their computer slot, account RAM, per-computer CPU/RAM ceiling, and the storage the source’s disk requires. Any of those being exhausted returns 403. See https://orgo.ai/pricing.

Example

curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/clone \
  -H "Authorization: Bearer $ORGO_API_KEY"

import requests

response = requests.post(
    f"https://www.orgo.ai/api/computers/{computer_id}/clone",
    headers={"Authorization": f"Bearer {api_key}"}
)

clone = response.json()
print(f"Clone created: {clone['name']} ({clone['id']})")

const response = await fetch(`https://www.orgo.ai/api/computers/${computerId}/clone`, {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const clone = await response.json();
console.log(`Clone created: ${clone.name} (${clone.id})`);

Response

{
  "id": "b4cc290f-9bf9-3888-9912-ace4e6543003",
  "name": "agent-1 (clone)",
  "status": "running",
  "fly_instance_id": "b4cc290f"
}

Errors

Every error body carries error and code.

Status	`code`	When
`400`	`INVALID_REQUEST`	The body is not a JSON object, or `name` is not a string of 1-255 characters after trimming.
`400`	`DEVICE_LIFECYCLE_UNSUPPORTED`	The source runs on a dedicated machine that Orgo manages directly. Contact support.
`400`	`NOT_CLONABLE`	The source has no server address on record, so it was never fully provisioned.
`400`	`NO_INSTANCE`	The source has no `instance_id` on record. It is `frozen` or still being created.
`401`	`UNAUTHENTICATED`	The Bearer token starts with `sk_` but is not a known Orgo key. The body is `{ "error": "Invalid API key", "code": "UNAUTHENTICATED" }`.
`401`	`UNAUTHENTICATED`	No `Authorization` header, or a Bearer token that is not an `sk_` key. The body is `{ "error": "Authentication required", "code": "UNAUTHENTICATED" }`.
`401`	`UNAUTHENTICATED`	You are not the owner or a member of the source’s workspace (`You do not have access to this workspace.`), you are a view-only member (`This workspace is view-only. Ask the owner for write access (workspace_read_only).`), or the API key is scoped to another workspace (`This API key cannot access this workspace (workspace_scope_mismatch).`). These checks run during authentication, so they return `401`, not `403`.
`401`	`UNAUTHENTICATED`	The credential store is unavailable: `Service temporarily unavailable. The database is not accepting requests. Retry shortly.` Retry; your key is not the problem.
`402`	`NOT_A_MEMBER`	The source is a trial computer whose trial has ended. The body is `{ "error": "Choose a plan to continue.", "code": "NOT_A_MEMBER" }`.
`403`	`GUEST_RESTRICTED`	Share-link guests cannot create computers.
`403`	`DESKTOP_LIMIT`, `UPGRADE_REQUIRED`, `VM_SLOT_ADDON`, `RAM_ADDON`, `VCPU_ADDON`, `PER_COMPUTER_RAM_CAP`, `PER_COMPUTER_CPU_CAP`, `CHANGE_PLAN`, `PLAN_LIMIT`	The owner’s plan cannot fund another computer of this size. `PLAN_LIMIT` means a limit of a plan negotiated with Orgo. Also carries `upgradeTier` where a plan change would fix it.
`403`	`DISK_QUOTA_EXCEEDED`	The source’s disk is larger than the per-computer storage the owner’s plan allows. Also carries `max_disk_gb`.
`404`	`NOT_FOUND`	No computer matches the id, or its workspace no longer exists.
`409`	`NAME_TAKEN`	A computer with the requested `name` already exists in the workspace.
`409`	`HOURLY_QUOTE_REQUIRED`	The source is billed hourly or by its own subscription, so a copy needs its own purchase.
`500`	`AUTH_LOOKUP_FAILED`	The account could not be verified.
`500`	`INSERT_FAILED`	The clone record could not be saved.
`500`	`CLONE_FAILED`	The copy failed on the host. The placeholder record is rolled back, so no half-made computer is left behind.

{
  "error": "This computer can’t be cloned (no server address on record).",
  "code": "NOT_CLONABLE"
}

Optional name

string

A unique name of 1-255 characters after trimming. Omit the body to generate a name. An empty or invalid name returns 400 with code INVALID_REQUEST; a name collision returns 409 with code NAME_TAKEN.

Cloning is a disk copy, so stop applications that require an application-consistent backup before cloning. Guest flush and snapshot consistency depend on the computer backend.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Source computer ID

Body

application/json

name

string

Optional unique clone name. Omit to generate a (clone) suffix.

Required string length: 1 - 255

Response

Clone created and running

string

New computer UUID.

name

string

Example:

"agent-1 (clone)"

status

enum<string>

Available options:

running

fly_instance_id

string

The clone's instance_id.

Clone computer

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/clone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

import requests

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

payload = { "name": "<string>" }
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: '<string>'})
};

fetch('https://www.orgo.ai/api/computers/{id}/clone', 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}/clone",
  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' => '<string>'
  ]),
  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}/clone"

	payload := strings.NewReader("{\n  \"name\": \"<string>\"\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/computers/{id}/clone")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"<string>\"\n}"

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

{
  "id": "b4cc290f-9bf9-3888-9912-ace4e6543003",
  "name": "agent-1 (clone)",
  "status": "running",
  "fly_instance_id": "b4cc290f"
}

Overview

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Clone computer

Clone or fork?

Path parameters

Response

Plan limits

Example

Response

Errors

Optional name

Authorizations

Path Parameters

Body

Response

​Clone or fork?

​Path parameters

​Response

​Plan limits

​Example

​Response

​Errors

​Optional name

Authorizations

Path Parameters

Body

Response

Clone or fork?

Path parameters

Response

Plan limits

Example

Response

Errors

Optional name