Skip to main content
PUT
Set public visibility

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

Stable public computer identifier.

Minimum string length: 1
Example:

"cmp_123"

Body

application/json
visibility
enum<string>
required
Available options:
public,
private

Response

The current computer state.

id
string
required
hostname
string
required
slug
string
required
ip
string
required
status
string
required
visibility
enum<string>
required
Available options:
private,
public
access
enum<string>
required
Available options:
owner,
can_use
site
boolean
required

The URL serves the computer's published files: from the edge, or from its VM's built-in site server, which answers what no file matches with the program on the exposed port.

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.

created_at
string<date-time>
required
public_url
string<uri>
email_address
string<email>
auto_delete_at
string<date-time> | null
creation_mode
string