Orgo - Cloud computers for AI agents

Sends this computer’s Google Chrome out through a home internet connection instead of the data center, moves it to a new IP, or turns that off. Browser networking covers what a residential IP is for and which sites fail on one.

This works on Linux computers only. Only Google Chrome goes through the proxy: the terminal, other browsers and agent API calls keep the data center address.

Turn on a residential IP

curl -X POST "https://www.orgo.ai/api/computers/$COMPUTER_ID/residential-proxy" \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

Replace $COMPUTER_ID with the computer’s UUID. The computer must be running.

{
  "proxy_on": true,
  "exit_ip": "203.0.113.24",
  "country": "us",
  "quota": {
    "granted_bytes": 5368709120,
    "used_bytes": 1288490188,
    "remaining_bytes": 4080218932
  }
}

Turning it on restarts Chrome once, so open tabs close. Residential data belongs to the workspace owner, and accounts start with none. Until the account has data, this answers 409 with Residential proxy is turned off for this account. To ask for data, email contact@orgo.ai.

Get a new IP

curl -X POST "https://www.orgo.ai/api/computers/$COMPUTER_ID/residential-proxy" \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "new_ip": true}'

When the proxy is already on, Chrome keeps running and open connections drop. When it is off, this turns it on with a new IP and restarts Chrome. A computer using your own proxy or device keeps its address: new_ip gets no new IP there.

New IP limits

Limit	Count
Per computer	One a minute and 30 a day
Per account	200 a day

A day ends at 00:00 UTC, and an attempt that fails still counts. Past a limit the answer is 429 with a Retry-After header:

{
  "error": "A computer can get one new IP every 60 seconds. Try again in 42 seconds.",
  "code": "residential_new_ip_limited",
  "retry_after": 42
}

Turn off a residential IP

curl -X POST "https://www.orgo.ai/api/computers/$COMPUTER_ID/residential-proxy" \
  -H "Authorization: Bearer $ORGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Chrome goes back to the data center address and restarts if it is open. On an asleep computer this answers "proxy_on": false at once, and the proxy comes off when the computer wakes.

Choose a country

Residential IPs are US only for now. country takes us, and leaving it out means the same. Any other value answers 400:

{
  "error": "Only US IPs are available right now. To ask about other countries, email contact@orgo.ai.",
  "code": "residential_country_unavailable"
}

To ask about another country, email contact@orgo.ai.

When a site fails

Some sites can’t be reached through a residential IP, and Chrome shows ERR_TUNNEL_CONNECTION_FAILED for them. They fail rather than falling back to the data center address. Orgo blocks ticketing, video and music streaming, gambling, torrent and speed test sites. DataImpulse, the network behind residential IPs, blocks banks, payment sites and government sites itself. Webmail in the browser works. Blocked sites by category has the detail.

When the data runs out

The computers using it go back to the data center address, which restarts Chrome, and turning it on answers 409 with Residential data quota is used up for this account. Read what is left with Get residential IP status.

When Orgo refuses a change

Each of these answers 409 and changes nothing:

`error`	What it means
`Residential proxy is turned off for this account`	The account has no residential data.
`Residential data quota is used up for this account`	The account’s data is used up.
`Residential proxy is paused for this computer` or `for this account`	Orgo has paused residential IPs here. Email contact@orgo.ai.
`New IP is paused for this computer`	Orgo has paused New IP here. The current IP keeps working.
`Residential data is not available right now. Try again later`	Orgo can’t add data right now. Try again later.
`This computer has a dedicated IP. Turn that off before routing its browser elsewhere.`	The computer has a dedicated IP.
`This computer is asleep. Wake it to apply this change.`	Code `computer_asleep`. Resume or start the computer.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

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

Body

application/json

enabled

boolean

required

true turns it on and keeps the sticky IP. false turns it off.

new_ip

boolean

default:false

With enabled: true, moves to a different IP. Ignored with enabled: false.

country

enum<string>

The exit country. Only us for now, and leaving it out means the same. To ask about other countries, email contact@orgo.ai.

Available options:

us

Response

The status after the change. exit_ip is null if Orgo could not read one.

A computer's residential IP and the account's residential data.

proxy_on

boolean

required

true while this computer's Chrome goes through the proxy.

exit_ip

string | null

required

The last exit IP Orgo saw. null while the proxy is off, or if Orgo could not read one.

country

string

required

The exit country: us.

quota

object

required

The workspace owner's residential data, shared by every computer in the account. DataImpulse's count as of Orgo's last hourly sync, so it can be up to an hour behind.

Show child attributes

changed

boolean

Only with ?check=1: this reading differs from the last exit IP Orgo saw.

checked_at

string<date-time>

Only with ?check=1: when it was read.

Overview

API keys

Support

Account

Agent accounts

Clients

Computer Use API

Workspaces

Computers

Computer Lifecycle

Computer Actions

Screens

Files

Templates

Turn a residential IP on or off

Turn on a residential IP

Get a new IP

New IP limits

Turn off a residential IP

Choose a country

When a site fails

When the data runs out

When Orgo refuses a change

Authorizations

Path Parameters

Body

Response

​Turn on a residential IP

​Get a new IP

​New IP limits

​Turn off a residential IP

​Choose a country

​When a site fails

​When the data runs out

​When Orgo refuses a change

Authorizations

Path Parameters

Body

Response

Turn on a residential IP

Get a new IP

New IP limits

Turn off a residential IP

Choose a country

When a site fails

When the data runs out

When Orgo refuses a change