Skip to main content
PUT
Register a computer

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

computerID
string<uuid>
required
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Body

application/json
name
string
required
Required string length: 1 - 100
secret
string

The computer's own secret, 32 random bytes as 64 lower-case hex characters (^[0-9a-f]{64}$), which aether setup made and keeps on it.

Response

OK

agent_starts
object
required

The computer's "let Aether start agents here" switch: off, or on with the most agents Aether runs on it at once.

agents
object[]
required

The agents the computer's machine bridge declared as it last connected, kept while the computer is unreachable; none for a bridge that declared nothing.

bridge
object
required
id
string<uuid>
required
last_seen_at
string<date-time>
required
name
string
required
Required string length: 1 - 100
reachable
boolean
required

Whether the computer's machine bridge is connected to Aether.

registered_at
string<date-time>
required
remote_changes
object
required

The computer's "changes from other devices" switch: on, a live connection from another device may open a terminal and change the files of its task on the computer; off, it may not. Only the computer itself turns it on.

set_up_at
string<date-time> | null
required

When aether setup last set the computer's own secret; null while it has none.