Nodes

Mesh state, per-node connection and join onboarding for the Worker Nodes page.

Changed on
get/nodes/wireguard

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/nodes/wireguard
  • Auth: HTTP bearer

Response

WireGuard mesh state

can_enableboolean required

Whether POST /nodes/wireguard can turn the mesh on here.

cidrstring nullable

Mesh address pool, when enabled.

enable_blockerstring nullable

What prevents enabling it, when can_enable is false and the mesh is off. Rendered verbatim.

enable_commandstring required

CLI equivalent of enabling, for the control-plane host.

handshake_errorstring nullable

Why handshake data is missing, when it is.

join_urlstring nullable

The configured external URL: what temps join should point at. null when none is configured.

listen_portinteger required

UDP port every node must accept from the others — the configured one even while the mesh is off, so it can be opened in advance.

reasonstring nullable

Why the mesh is not ready, when it is not. Rendered verbatim.

state'disabled' | 'starting' | 'ready' required

Whether the cluster's mesh is carrying traffic.

Changes