Orgo - Cloud computers for AI agents

POST

computers

{id}

start

Start computer

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

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

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

	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}/start")

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

{
  "success": true
}

Starts a computer that is frozen or stopped. Its archived disk is restored, including files, installed software, and configuration. It cold-boots on a freshly chosen host.

A started computer receives a new IP address, new ports, and a new VNC / Desktop API token, so re-fetch GET /computers/{id} afterwards. Only the disk is restored: processes and other in-memory state from before the stop are gone. The call can take considerably longer than a normal request while the saved disk is fetched and the computer boots.

Path parameters

string

required

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

Response

boolean

true when the start succeeded or the computer was already running.

boolean

Present and true only when the computer’s record said stopped but the computer was still running on its host, so the record was corrected instead of a second copy being booted. No boot happened.

Starting is idempotent for an already-running computer: it returns { "success": true } and changes nothing. Only frozen and stopped computers are startable. Every other status returns 409. A suspended computer resumes on interaction rather than through this endpoint.

Example

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

import requests

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

if response.json().get("success"):
    print("Computer starting")

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

const { success } = await response.json();
if (success) console.log('Computer starting');

Response

{
  "success": true
}

Errors

Status	Body	When
`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.
`402`	`{ "error": "…", "code": "upgrade_required" }`	The workspace owner’s plan no longer funds running computers. The archived disk is kept; upgrading re-enables start.
`403`	`{ "error": "Access denied" }`	You are neither the owner nor a member of the computer’s workspace.
`404`	`{ "error": "Desktop not found" }`	No computer matches the id.
`409`	`{ "error": "Computer cannot be started (status: creating)", "code": "not_startable" }`	The computer is in a status other than `frozen`, `stopped`, or `running`.
`409`	`{ "error": "No saved state found for this computer" }`	The computer has no archived disk to restore.
`500`	`{ "error": "…" }`	The start failed for an unclassified reason. The computer is left `frozen` with its archive intact, so a retry can start it.
`503`	`{ "error": "…", "code": "golden_unavailable" }`	The base image could not be resolved on the chosen host.
`503`	`{ "error": "…", "code": "frozen_disabled" }`	Archived-disk storage is not configured for this fleet.
`503`	`{ "error": "…", "code": "NO_TEMPLATE_HOST" }`	No host could take the boot.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer ID

Response

Computer starting

success

boolean

Example:

true

Start computer

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

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

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

	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}/start")

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

{
  "success": true
}

Overview

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Start computer

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