Orgo - Cloud computers for AI agents

POST

computers

{id}

fork

Fork computer

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

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

fetch('https://www.orgo.ai/api/computers/{id}/fork', 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}/fork",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/computers/{id}/fork"

	req, _ := http.NewRequest("POST", 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/computers/{id}/fork")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "7f3a9c21-5e8b-4d0a-b6c4-1e2f3a4b5c6d",
  "name": "agent-1 (fork)",
  "status": "running",
  "fly_instance_id": "7f3a9c21"
}

Creates a copy of a running Linux computer, including what is in its memory. The fork comes up running in the source’s workspace with the same apps, windows, and processes open, so an agent can carry on from the exact same point.

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.

The source pauses for about two seconds while its memory is copied, then carries on. The fork gets a new UUID and a new instance_id. Its auto-stop is forced to always-on regardless of the source’s setting.

Path parameters

string

required

The source computer’s instance_id: the value POST /computers returns as instance_id, and GET /computers/{id} as fly_instance_id. Unlike clone, fork does not take the UUID: a UUID returns 404.

Response

Returns 201 once the fork is running. The request has no body.

string

New computer UUID.

string

A generated name: agent-1 (fork), then agent-1 (fork 2).

string

Always running: the response is sent after the fork has resumed.

string

The fork’s instance_id. Use it for the fork’s own calls, including another fork.

Plan limits

A fork 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/$INSTANCE_ID/fork \
  -H "Authorization: Bearer $ORGO_API_KEY"

import requests

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

fork = response.json()
print(f"Fork created: {fork['name']} ({fork['fly_instance_id']})")

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

const fork = await response.json();
console.log(`Fork created: ${fork.name} (${fork.fly_instance_id})`);

Response

{
  "id": "7f3a9c21-5e8b-4d0a-b6c4-1e2f3a4b5c6d",
  "name": "agent-1 (fork)",
  "status": "running",
  "fly_instance_id": "7f3a9c21"
}

Errors

Every error body carries error and code.

Status	`code`	When
`400`	`DEVICE_LIFECYCLE_UNSUPPORTED`	The source runs on a dedicated machine that Orgo manages directly.
`400`	`NOT_FORKABLE`	The source has no server address on record, so it was never fully provisioned.
`401`	`UNAUTHENTICATED`	No valid API key, or the key can’t change the source’s workspace: you are not a member, you are view-only, or the key is scoped to another workspace. 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.
`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 has this `instance_id`, or its workspace no longer exists.
`409`	`NOT_FORKABLE`	The source is not running, is a Windows computer, or runs on an older VM type that cannot fork live. Create a new computer to fork, or contact support to migrate this one.
`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 fork record could not be saved.
`500`	`FORK_FAILED`	The copy failed on the host. The placeholder record is rolled back, so no half-made computer is left behind.

{
  "error": "This computer must be running to fork (a fork copies its live memory).",
  "code": "NOT_FORKABLE"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Source computer instance_id

Response

Fork created and running

string

New computer UUID.

name

string

Example:

"agent-1 (fork)"

status

enum<string>

Available options:

running

fly_instance_id

string

The fork's instance_id.

Fork computer

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

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

fetch('https://www.orgo.ai/api/computers/{id}/fork', 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}/fork",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/computers/{id}/fork"

	req, _ := http.NewRequest("POST", 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/computers/{id}/fork")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "7f3a9c21-5e8b-4d0a-b6c4-1e2f3a4b5c6d",
  "name": "agent-1 (fork)",
  "status": "running",
  "fly_instance_id": "7f3a9c21"
}

Overview

Account

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Fork computer

Clone or fork?

Path parameters

Response

Plan limits

Example

Response

Errors

Authorizations

Path Parameters

Response

​Clone or fork?

​Path parameters

​Response

​Plan limits

​Example

​Response

​Errors

Authorizations

Path Parameters

Response

Clone or fork?

Path parameters

Response

Plan limits

Example

Response

Errors