Skip to main content
GET
Get the computer's custom domain

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 custom domain.

hostname
string
required

The hostname, lowercase, in its punycode form.

state
enum<string>
required
Available options:
challenge,
issuing,
serving,
active,
removing
records
object[]
required

The DNS records to publish: TXT _cool-challenge. with the challenge value, and the CNAME of the hostname.

detail
string

What the domain waits for, or why it was removed.

challenge_expires_at
string<date-time>

While the state is challenge: when the request is dropped if the TXT record has not appeared.