Skip to main content
GET
Inspect network settings

Authorizations

Authorization
string
header
required

A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

Path Parameters

id
string
required

The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.

Minimum string length: 1
Example:

"agent-atlas"

Response

The computer's public routing and outbound network settings.

id
string
required
name
string
required
status
string
required
visibility
enum<string>
required
Available options:
public,
private
network_policy
object
required

Outbound access policy. open allows public destinations, none blocks outbound access, and allowlist permits only the named public hosts. Private and reserved addresses remain blocked.

integration_hosts
string[]
required

Hosts the allowlist and none modes also allow while their provider is connected to the account: each connected harness's API and update hosts, and GitHub's while an installation is active.

url
string<uri>
port
integer

The port the computer's URL forwards to, while one is exposed.

Required range: 1 <= x <= 65535
warning
string

Present when the network is not what the policy and connected providers ask for, with what to do next: for example, provider hosts that would push the allowlist past 100 hosts are blocked until allowed hosts are removed or a provider is disconnected.