Orgo - Cloud computers for AI agents

POST

computers

{id}

restart

Restart computer

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

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

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

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

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
}

Reboots a computer in place on the host it is already running on. The disk is untouched; memory and running processes are not.

A restart keeps the computer’s ports and VNC password. Orgo rewrites the stored connection details from what the host reports afterwards, so re-fetch GET /computers/{id} if you need to be certain. Open VNC and terminal WebSockets drop during the reboot.

A frozen computer has no host, so restarting it returns 500. Use start instead. A stopped computer whose virtual machine is still on its host is booted there, which requires a plan that funds running computers.

Path parameters

string

required

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

Response

boolean

true when the computer restarted. The response is sent after the reboot completes, not when it is queued.

Use cases

Recover from a hung or unresponsive computer
Reset the running environment

Example

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

import requests

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

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

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

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

Response

{
  "success": true
}

Errors

Status	Body	When
`400`	`{ "error": "…", "code": "DEVICE_LIFECYCLE_UNSUPPORTED" }`	The computer runs on a dedicated machine Orgo manages directly. Contact support.
`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": "Your plan does not include running computers. Upgrade to restart this computer.", "code": "upgrade_required" }`	The computer is not `running` and the workspace owner’s plan no longer funds running computers.
`402`	`{ "error": "Choose a plan to continue." }`	The computer is a trial computer whose trial has ended.
`403`	`{ "error": "You do not have access to this workspace." }`	You are not a member of the computer’s workspace.
`403`	`{ "error": "This workspace is view-only. Ask the owner for write access (workspace_read_only)." }`	You have view-only access to the workspace.
`403`	`{ "error": "This API key cannot access this workspace (workspace_scope_mismatch)." }`	The API key is scoped to a different workspace.
`404`	`{ "error": "Desktop not found" }`	No computer matches the id.
`409`	`{ "error": "This computer is paused. Resume it first, then restart it.", "code": "suspended" }`	The computer is `suspended`.
`409`	`{ "error": "…", "code": "migrating" }`	The computer is being moved to another host. Retry in a few minutes.
`409`	`{ "error": "…", "code": "NOT_ON_HOST" }`	The host no longer has the computer, and the computer has no archive to start from. Contact support.
`409`	`{ "error": "pool_mac_release_required", "message": "This Mac is managed by Orgo. Ask support to release it." }`	The computer is a Mac that has been released back to Orgo.
`500`	`{ "error": "…" }`	Every other failure: a computer with no live host, a host that refused or could not be reached, or an error during the reboot. The body carries the underlying message.
`503`	`{ "error": "Service temporarily unavailable. …" }`	Orgo could not verify the credential because of a server-side fault. The response carries `Retry-After: 5`. Retry after that delay.

A failed restart changes the computer’s status only to what its host confirms, such as stopped or error. When the host cannot be reached, the computer keeps the status it had before the call.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer ID

Response

The computer restarted

success

boolean

Example:

true

Restart computer

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

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

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

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

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

Account

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Restart computer

Path parameters

Response

Use cases

Example

Response

Errors

Authorizations

Path Parameters

Response

​Path parameters

​Response

​Use cases

​Example

​Response

​Errors

Authorizations

Path Parameters

Response

Path parameters

Response

Use cases

Example

Response

Errors