Orgo - Cloud computers for AI agents

POST

computers

{id}

resume

Resume computer

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

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

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

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

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,
  "status": "running"
}

Resumes a suspended computer. Its memory is restored, so open windows and running processes continue exactly where they were. A computer still on its host comes back in seconds. One that was moved off its host to storage is woken on a host with room, in about a minute.

A computer woken from storage gets a new instance_id and can land on a different host with a different address and ports. Keep its UUID as your handle and re-fetch GET /computers/{id} once it is running. While it wakes, GET /computers/{id} reports progress in asleep.waking.

Path parameters

string

required

Computer UUID or instance_id. Both resolve to the same computer. A computer asleep in storage has no instance_id, so address it by UUID.

Response

boolean

true when the computer is running, or its resume or wake has started.

string

running with 200: the computer is back. resuming with 202: its memory is still being brought back from storage. Poll Get suspension until status reads running. Absent on a wake from storage.

boolean

Present and true with every 202.

boolean

Present and true with a 202 for a computer woken from storage.

integer

Present alongside waking. About how long the wake takes.

Resuming is idempotent. A computer that is already running returns 200 with status: "running", and one already resuming returns 202 again. A computer that runs by the hour has its running time reserved from credit before it resumes.

Example

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

import requests

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

print(response.status_code, response.json())

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

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

Response

{
  "success": true,
  "status": "running"
}

A computer woken from storage returns 202:

{
  "success": true,
  "pending": true,
  "waking": true,
  "expected_seconds": 90
}

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": "Your plan does not include running computers. Upgrade to resume this computer.", "code": "upgrade_required" }`	The workspace owner’s plan no longer funds running computers.
`402`	`{ "error": "Add credit to start this computer.", "code": "INSUFFICIENT_COMPUTE_CREDIT" }`	The computer runs by the hour and there is not enough credit to reserve its running time.
`402`	`{ "error": "Choose a plan to continue." }`	The computer is a trial computer whose trial has ended. `error` is “Manage this computer’s payment in Account → Usage.” when its payment is managed there.
`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": "Computer is not suspended (status: frozen)" }`	The computer is not `suspended`, `suspending`, `resuming`, or `running`. Use Start for a `frozen` or `stopped` computer.
`409`	`{ "error": "This computer is still being saved to storage. Try again once it shows Suspended.", "code": "suspend_in_progress" }`	A suspend is still being saved.
`409`	`{ "error": "This computer is being moved to another host. Try again in a few minutes.", "code": "migrating" }`	The computer is being moved to another host.
`409`	`{ "error": "…", "code": "suspend_state_missing" }` or `"disk_changed"`	The saved memory is missing, or the disk changed after the suspend. The computer stays suspended. Contact support.
`409`	`{ "error": "Computer can't be resumed right now (status: …)" }`	Its host refused the resume and the computer is in another state there.
`500`	`{ "error": "…" }`	The resume failed.
`503`	`{ "error": "…", "code": "…" }`	Nothing was tried. `code` is `suspend_state_unavailable` (the saved memory can’t be reached) or `insufficient_disk` (its host has no room yet). Carries `Retry-After: 30`.
`503`	`{ "error": "…", "code": "…" }`	A wake from storage failed under 30 seconds ago. `code` is `wake_failed`, `no_capacity`, or `saved_state_unavailable`. Carries `retry_after` and `Retry-After`.
`503`	`{ "error": "Running credit could not be confirmed. Please retry.", "code": "HOURLY_FUNDING_UNAVAILABLE" }`	An hourly computer’s credit could not be checked. Retry.
`503`	`{ "error": "Computer has no host recorded. Contact support" }`	The computer has no host on record.
`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.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Computer UUID or instance_id

Response

Running.

success

boolean

status

enum<string>

Available options:

running

Resume computer

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

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

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

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

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,
  "status": "running"
}

Overview

Account

Agent accounts

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Resume 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