Orgo - Cloud computers for AI agents

POST

computers

{id}

extend

Extend computer

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{
  "hours": 720
}'

import requests

url = "https://www.orgo.ai/api/computers/{id}/extend"

payload = { "hours": 720 }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({hours: 720})
};

fetch('https://www.orgo.ai/api/computers/{id}/extend', 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}/extend",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'hours' => 720
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/extend"

	payload := strings.NewReader("{\n  \"hours\": 720\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/computers/{id}/extend")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"hours\": 720\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/extend")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"hours\": 720\n}"

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

Adds hours to the end a computer already has. The computer keeps running, and it is deleted at its new end. Update computer sets an end counted from now, so "ends_in_hours": 24 on a computer with three days left shortens it to one day. Extend adds to what is left, so it only ever lengthens, and it can take the end further out: up to 90 days from now, where Update computer stops at 30.

Extending does not keep a computer for good. When the new end comes, the computer is deleted with everything on it. To keep it, take the end off with Update computer and "ends_at": null.

Extending needs write access to the workspace. Only a computer that has an end can be extended.

Headers

string

required

8 to 255 printable characters, such as a UUID. Required, because repeating this call would otherwise add the time twice. Send a new key for each extend, and the same key when you retry one. Retries has the rules.

Path parameters

string

required

Computer ID. Accepts the computer’s UUID or its instance_id.

Body

integer

required

Hours to add, a whole number from 1 to 2160. The new end is the current ends_at plus hours. If ends_at has just passed and the computer has not been deleted yet, it is now plus hours. The new end can be at most 2160 hours (90 days) from now.

How extending is billed

A computer on the plan is paid for by the plan. Only its end moves, and nothing is prepaid. On a computer that runs by the hour and is running, the prepay follows the new end in the same step, as it does on Update computer. What the old prepay has not used comes back and the run to the new end is held, so it needs only the extra. When your credit cannot cover the extra plus an hour of your other hourly computers that are not prepaid, the request returns 402 and nothing changes. Only the workspace owner can prepay. On a paid plan the owner must also be signed in, or use a key with Billing write. A caller who may not prepay but has write access still moves the end: nothing more is held, the time past the old prepay is billed by the hour, and the answer carries prepay_warning. An hourly computer that is stopped keeps its new end and stays billed by the hour, with no prepay.

Retries

A retry with the same key and body gets the first answer back with the header Idempotent-Replayed: true. Nothing more is added or held.
A refused request changes nothing and frees its key, so you can send the same key again once the reason is fixed, for example after adding credit.
The same key with another body returns 422.
A retry while the first is still running returns 409 with code idempotency_in_progress. Try again in a few seconds.
A request that did not finish returns 409 with code idempotency_unfinished on its retry, because the end may have moved. Read the computer with Get computer before you try again with a new key.

Keys last a day.

Response

string

Computer identifier (UUID).

string

Computer name.

string

The new end, as an ISO 8601 time.

string

Read only: "delete". An extended computer is deleted at its new end, also if its old end would have stopped it.

string | null

null.

string

When Orgo deletes the computer, which is ends_at.

string | null

On a computer that runs by the hour. When its prepaid run ends now, or null when its time is not prepaid.

integer | null

Present alongside prepaid_until. What is held from your credits for the run now, in cents. null when prepaid_until is.

integer

Present when some of the earlier prepay came back to your credits, in cents.

string

Present when the end moved but its time was not prepaid.

Example

Add 30 days to an hourly Medium ($0.055 an hour) that has 10 days left.

curl -X POST https://www.orgo.ai/api/computers/$COMPUTER_ID/extend \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"hours": 720}'

{
  "id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
  "name": "agent-1",
  "ends_at": "2026-12-14T09:30:00.000Z",
  "ended_at": null,
  "deletes_at": "2026-12-14T09:30:00.000Z",
  "on_end": "delete",
  "prepaid_until": "2026-12-14T09:30:00.000Z",
  "prepaid_cents": 5280,
  "prepay_returned_cents": 1320
}

Errors

Status	`code`	When
`400`	`idempotency_key_required`	No `Idempotency-Key` header.
`400`	`invalid_idempotency_key`	The key is not 8 to 255 printable characters.
`400`	`INVALID_ENDS`	`hours` is not a whole number from 1 to 2160, or the new end would be more than 2160 hours from now. The message says how many more hours the computer can take.
`400`	`ENDS_NOT_SUPPORTED`	`Only Linux and Windows computers can have an end.`
`402`	`insufficient_credit`	Your credit can’t prepay the run to the new end. The body has `needed_cents`, `available_cents` and, when your other computers are kept an hour, `keep_cents`. Nothing changed.
`403`	`workspace_read_only`	Your access to the workspace is view only.
`403`	`computer_key`, `computer_scope`	A computer’s own key, or a key for one computer, can’t change an end. Use a key for your account.
`409`	`NO_END`	`This computer has no end, so it already runs until you stop or delete it.`
`409`	`END_RAN_OUT`	The computer was stopped when an older end ran out. Give it a new end, or take the end off, with Update computer.
`409`	`COMPUTER_BUSY`	`This computer is busy right now, so its end did not change. Try again in a minute.` A stop, a start or the end itself holds the computer, or its end just moved. Send the same request again.
`409`	`idempotency_in_progress`, `idempotency_unfinished`	See Retries.
`422`	`idempotency_key_reused`	The key was used for a different body.
`503`	`ENDS_UNAVAILABLE`, `idempotency_unavailable`	Nothing changed. Try again shortly.

Authorizations

Authorization

string

header

required

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

Headers

Idempotency-Key

string

required

8 to 255 printable characters, such as a UUID. A retry with the same key and body gets the first answer back and adds nothing. A refused request frees its key. Keys last a day.

Required string length: 8 - 255

Path Parameters

string

required

Computer ID. Accepts the computer's UUID or its instance_id.

Body

application/json

hours

integer

required

Hours to add to the end the computer has.

Required range: 1 <= x <= 2160

Example:

720

Response

The end moved. Same fields as changing the end with Update computer: id, name, ends_at, on_end, ended_at and deletes_at, and on an hourly computer prepaid_until, prepaid_cents, and when they apply prepay_returned_cents and prepay_warning.

Extend computer

curl --request POST \
  --url https://www.orgo.ai/api/computers/{id}/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{
  "hours": 720
}'

import requests

url = "https://www.orgo.ai/api/computers/{id}/extend"

payload = { "hours": 720 }
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({hours: 720})
};

fetch('https://www.orgo.ai/api/computers/{id}/extend', 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}/extend",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'hours' => 720
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.orgo.ai/api/computers/{id}/extend"

	payload := strings.NewReader("{\n  \"hours\": 720\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/computers/{id}/extend")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"hours\": 720\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/computers/{id}/extend")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"hours\": 720\n}"

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

Overview

API keys

Support

Account

Agent accounts

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Extend computer

Headers

Path parameters

Body

How extending is billed

Retries

Response

Example

Errors

Authorizations

Headers

Path Parameters

Body

Response

​Headers

​Path parameters

​Body

​How extending is billed

​Retries

​Response

​Example

​Errors

Authorizations

Headers

Path Parameters

Body

Response

Headers

Path parameters

Body

How extending is billed

Retries

Response

Example

Errors