Orgo - Cloud computers for AI agents

POST

account

capacity

Add capacity

curl --request POST \
  --url https://www.orgo.ai/api/account/capacity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "size": "medium",
  "count": 100
}
'

import requests

url = "https://www.orgo.ai/api/account/capacity"

payload = {
    "size": "medium",
    "count": 100
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({size: 'medium', count: 100})
};

fetch('https://www.orgo.ai/api/account/capacity', 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/account/capacity",
  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([
    'size' => 'medium',
    'count' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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/account/capacity"

	payload := strings.NewReader("{\n  \"size\": \"medium\",\n  \"count\": 100\n}")

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

	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/account/capacity")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"size\": \"medium\",\n  \"count\": 100\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/account/capacity")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"size\": \"medium\",\n  \"count\": 100\n}"

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

{
  "added": {
    "size": "<string>",
    "count": 123,
    "os": "<string>",
    "term": "<string>"
  },
  "capacity": {
    "plan": "<string>",
    "computers": {
      "limit": 123,
      "in_use": 123
    },
    "ram_gb": {
      "limit": 123,
      "in_use": 123
    },
    "added": {
      "computers": 123,
      "ram_gb": 123,
      "vcpu": 123,
      "disk_gb": 123
    },
    "self_serve_cap": {
      "computers": 123,
      "ram_gb": 123,
      "vcpu": 123,
      "disk_gb": 123
    },
    "can_add": {
      "small": 123,
      "medium": 123,
      "large": 123,
      "xl": 123,
      "2xl": 123
    },
    "max_per_request": 123,
    "sizes": [
      {
        "size": "small",
        "ram_gb": 123,
        "vcpu": 123,
        "disk_gb": 123,
        "monthly_usd": 123
      }
    ],
    "terms": [
      "monthly"
    ],
    "windows_available": true,
    "has_subscription": true,
    "renews_at": "2023-11-07T05:31:56Z",
    "scheduled_reduction": {
      "added_computers": 123,
      "effective_at": "2023-11-07T05:31:56Z"
    }
  }
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Adds count computers of size to the account, at the same prices as the Plan tab. The charge for the rest of the current period is made now, and the full amount joins every renewal after it.

curl -X POST https://www.orgo.ai/api/account/capacity \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "size": "medium", "count": 100 }'

Price it first

Send dry_run: true to see the charge without making it:

{ "size": "medium", "count": 100, "dry_run": true }

{
  "dry_run": true,
  "size": "medium",
  "count": 100,
  "os": "linux",
  "term": "monthly",
  "monthly_usd": 2500,
  "due_now_usd": 1650,
  "next_invoice_usd": 4149,
  "next_invoice_at": "2026-11-01T00:00:00.000Z"
}

Retries never buy twice

Send an Idempotency-Key header, a new UUID per purchase. If the connection drops before the answer arrives, retry with the same key and body: you get the first answer back, marked Idempotent-Replayed: true, and nothing is bought again.

Answer	Meaning
`409` `idempotency_in_progress`	The first request is still running. Retry in a few seconds.
`409` `idempotency_unfinished`	The first request did not finish and may have charged. Check Get capacity before trying again with a new key.
`422` `idempotency_key_reused`	The key was already used for a different body.

The self-serve cap

Every account can add up to 30 computers on its own (with up to 800 GB RAM, 50 vCPU and 2 TB of disk across them). Past that, a purchase returns 403 with code capacity_cap, naming the limit:

{
  "error": "That would go past this account's limit of 30 extra computers. Ask us to raise it.",
  "code": "capacity_cap",
  "self_serve_cap": { "computers": 30, "ram_gb": 800, "vcpu": 50, "disk_gb": 2000 }
}

Ask us and we raise the cap for the account, to thousands of computers if you need them. Nothing else about the account changes.

Authorizations

Authorization

string

header

required

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

Headers

Idempotency-Key

string

A unique value per purchase, such as a UUID (8 to 255 printable characters). Keys last 24 hours.

Required string length: 8 - 255

Body

application/json

size

enum<string>

required

The size of each computer.

Available options:

small,

medium,

large,

xl,

2xl

count

integer

required

How many computers to add.

Required range: 1 <= x <= 500

enum<string>

default:linux

windows adds a Windows license per computer, when windows_available is true.

Available options:

linux,

windows

term

enum<string>

default:monthly

Billing term, from terms.

Available options:

monthly,

yearly

dry_run

boolean

default:false

Price the purchase without making it.

Response

Added, with the account's capacity after it. For dry_run: monthly_usd, due_now_usd, next_invoice_usd and next_invoice_at, and nothing is charged.

added

object

Show child attributes

capacity

object

Show child attributes

Add capacity

curl --request POST \
  --url https://www.orgo.ai/api/account/capacity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "size": "medium",
  "count": 100
}
'

import requests

url = "https://www.orgo.ai/api/account/capacity"

payload = {
    "size": "medium",
    "count": 100
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({size: 'medium', count: 100})
};

fetch('https://www.orgo.ai/api/account/capacity', 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/account/capacity",
  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([
    'size' => 'medium',
    'count' => 100
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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/account/capacity"

	payload := strings.NewReader("{\n  \"size\": \"medium\",\n  \"count\": 100\n}")

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

	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/account/capacity")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"size\": \"medium\",\n  \"count\": 100\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.orgo.ai/api/account/capacity")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"size\": \"medium\",\n  \"count\": 100\n}"

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

{
  "added": {
    "size": "<string>",
    "count": 123,
    "os": "<string>",
    "term": "<string>"
  },
  "capacity": {
    "plan": "<string>",
    "computers": {
      "limit": 123,
      "in_use": 123
    },
    "ram_gb": {
      "limit": 123,
      "in_use": 123
    },
    "added": {
      "computers": 123,
      "ram_gb": 123,
      "vcpu": 123,
      "disk_gb": 123
    },
    "self_serve_cap": {
      "computers": 123,
      "ram_gb": 123,
      "vcpu": 123,
      "disk_gb": 123
    },
    "can_add": {
      "small": 123,
      "medium": 123,
      "large": 123,
      "xl": 123,
      "2xl": 123
    },
    "max_per_request": 123,
    "sizes": [
      {
        "size": "small",
        "ram_gb": 123,
        "vcpu": 123,
        "disk_gb": 123,
        "monthly_usd": 123
      }
    ],
    "terms": [
      "monthly"
    ],
    "windows_available": true,
    "has_subscription": true,
    "renews_at": "2023-11-07T05:31:56Z",
    "scheduled_reduction": {
      "added_computers": 123,
      "effective_at": "2023-11-07T05:31:56Z"
    }
  }
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Overview

Account

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Add capacity

Price it first

Retries never buy twice

The self-serve cap

Authorizations

Headers

Body

Response

​Price it first

​Retries never buy twice

​The self-serve cap

Authorizations

Headers

Body

Response

Price it first

Retries never buy twice

The self-serve cap