Skip to main content
GET
Get a host

Authorizations

Authorization
string
header
required

An opaque access token from /login or /refresh. Tokens are checked against the database on every request, so revocation is immediate.

Path Parameters

id
string<uuid>
required

Response

The host

id
string<uuid>
name
string
hostname
string
ssh_endpoint
object
accounts
string[]

The Unix accounts this host manages.

status
string
connection_status
string

Whether a daemon is currently connected.

agent_version
string
desired_version
string
enrolled_at
string<date-time>
last_seen_at
string<date-time> | null
permissions
string[]

The caller's permissions on this host.

connected
boolean

Whether the daemon's WebSocket is up right now.

encryption
boolean

Whether the host registered an X25519 key and can receive sealed sets.

sets
string[]