Orgo - Cloud computers for AI agents

GET

computers

{id}

suspension

Get suspension

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

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

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

	req, _ := http.NewRequest("GET", 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}/suspension")

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

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

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

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "status": "suspending",
  "suspension": {
    "state": "uploading",
    "kind": "ram",
    "bytes_done": 1073741824,
    "bytes_total": 4294967296,
    "progress": 0.25,
    "local_only": false,
    "failed": false,
    "suspended_at": "2026-10-13T09:00:00.000Z",
    "stored_at": null,
    "resume_started_at": null,
    "resumed_at": null,
    "updated_at": "2026-10-13T09:00:20.000Z",
    "where": "host",
    "saving": false,
    "region": null
  },
  "instance_details": {
    "provider": "metal"
  },
  "url": "http://198.51.100.24:8081"
}

Returns a computer’s status and its current suspension: whether its memory is still being saved, where it lives, and how far a copy has got. Poll it after a suspend or resume that returned 202, until status reads suspended or running. Anyone who can see the computer can read it.

Path parameters

string

required

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

Query parameters

string

resume asks Orgo to check a running computer against its host once more after a resume, so its connection details are up to date.

Response

string

Computer identifier (UUID).

string

The computer’s status, as Get computer reports it. While it is suspending or resuming, each read also checks its host, so a finished save or resume shows here.

object | null

The computer’s current or most recent suspension. null when none is recorded.

Show properties

string

capturing, uploading, stored, resuming, resumed, failed, or abandoned.

string

ram (memory and disk saved) or disk_only.

integer | null

Bytes saved so far.

integer | null

Bytes to save.

number | null

From 0 to 1. 1 once the copy is stored. null when the size is not known yet.

boolean

true when saving the copy failed and the computer’s memory is kept on its host only. It can still be resumed there.

boolean

true when state is failed.

string

host or storage. A computer in storage has left its host and wakes on Resume or Start.

boolean

true while the copy is still being saved to storage. The computer can be resumed or deleted meanwhile.

string | null

The storage region of the copy, or null.

string | null

ISO 8601 timestamp.

string | null

ISO 8601 timestamp.

string | null

ISO 8601 timestamp.

string | null

ISO 8601 timestamp.

string | null

ISO 8601 timestamp.

object | null

The computer’s placement and connection record, without its credentials.

string | null

The computer’s API address on its fleet host. See Get computer.

Example

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

import requests

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

data = response.json()
print(data["status"], data["suspension"])

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

const { status, suspension } = await response.json();
console.log(status, suspension);

Response

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "status": "suspended",
  "suspension": {
    "state": "uploading",
    "kind": "ram",
    "bytes_done": 2147483648,
    "bytes_total": 4294967296,
    "progress": 0.5,
    "local_only": false,
    "failed": false,
    "suspended_at": "2026-10-13T09:12:00.000Z",
    "stored_at": null,
    "resume_started_at": null,
    "resumed_at": null,
    "updated_at": "2026-10-13T09:12:40.000Z",
    "where": "host",
    "saving": true,
    "region": "nyc"
  },
  "instance_details": {
    "provider": "metal",
    "id": "a3881618",
    "resolution": "1280x720x24"
  },
  "url": "http://162.43.189.25:8231"
}

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": "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 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.
`500`	`{ "error": "Failed to read the computer’s suspension" }`	The read failed.
`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

Query Parameters

after

enum<string>

resume: also check a running computer that just resumed, so its connection details are current.

Available options:

resume

Response

The status and suspension.

string

status

string

The computer's status, as on GET /computers/{id}.

suspension

object | null

The newest suspension, or null when none is recorded.

Show child attributes

instance_details

object | null

The placement record, without credentials.

url

string | null

Get suspension

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

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

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

	req, _ := http.NewRequest("GET", 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}/suspension")

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

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

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

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "status": "suspending",
  "suspension": {
    "state": "uploading",
    "kind": "ram",
    "bytes_done": 1073741824,
    "bytes_total": 4294967296,
    "progress": 0.25,
    "local_only": false,
    "failed": false,
    "suspended_at": "2026-10-13T09:00:00.000Z",
    "stored_at": null,
    "resume_started_at": null,
    "resumed_at": null,
    "updated_at": "2026-10-13T09:00:20.000Z",
    "where": "host",
    "saving": false,
    "region": null
  },
  "instance_details": {
    "provider": "metal"
  },
  "url": "http://198.51.100.24:8081"
}

Overview

Account

Agent accounts

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Get suspension

Path parameters

Query parameters

Response

Example

Response

Errors

Authorizations

Path Parameters

Query Parameters

Response

​Path parameters

​Query parameters

​Response

​Example

​Response

​Errors

Authorizations

Path Parameters

Query Parameters

Response

Path parameters

Query parameters

Response

Example

Response

Errors