Network
Mesh registration, the mesh HTTP server and WebSocket diagnostics.
On this page
Network diagnostics (host, mesh, WebSockets, agents)
/networkResponses
| Status | Description | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Diagnostics | NetworkDiagnostics | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meshrequiredobject | 4 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enabledSettingrequired | boolean | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lanrequired | boolean | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
portrequired | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
statusrequired | MeshStatus | null | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
5 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meshEnabledrequired | boolean | |||||||||||||||||||||||||
meshServerRunningrequired | boolean | |||||||||||||||||||||||||
meshServerrequired | object | |||||||||||||||||||||||||
5 fields of | ||||||||||||||||||||||||||
runningrequired | boolean | |
portrequired | integer | |
hostrequired | string | |
lanAddresses | array<string> | Non-loopback addresses listening now. LAN mode (host 0.0.0.0: the Network switch, or an agent with lan or public visibility) listens on private-network and Tailscale addresses of allowed networks only (remote-access.md §3.3, §3.3.1), never on a public address. MESH_HOST set: [MESH_HOST] unless it is loopback. |
warning | string | Present while an agent with public visibility has no allowed network to listen on (it is reachable from this computer only, e.g. on a headless server with only a public address). It names MESH_HOST, which binds an address of the operator's choice. |
agentsrequired8 fields of agents
filePathrequired | string | |
handlerequired | string | |
did | string | |
agentId | string | |
icon | string | |
staterequired | string | Display (fleet-map) state of an agent |
status | string | |
model | string |
debugrequiredMesh manager internals (unstable)
websocketrequired3 fields of websocket
activeConnectionsrequired | integer | |
inboundConnectionsrequired | integer | |
outboundConnectionsrequired | integer |
agentsrequired10 fields of agents
agentIdrequired | string | |
handle | string | |
namerequired | string | |
filePathrequired | string | null | |
receiverequired | boolean | |
sendModerequired | string | null | |
networkrequired | string | null | |
wsConnectionsConfiguredrequired | integer | |
servingRoutesrequired | integer | |
publicServingEnabledrequired | boolean |
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Network diagnostics (same as GET /network)
/runtime/networkResponses
| Status | Description | Body |
|---|---|---|
| 200 | Diagnostics | NetworkDiagnostics |
Fields as in NetworkDiagnostics above. | ||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/runtime/network" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Live mesh status
/network/meshResponses
| Status | Description | Body | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Mesh status | MeshStatus | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
agentsrequiredarray<MeshAgentStatus> | 8 fields of | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
filePathrequired | string | |
handlerequired | string | |
did | string | |
agentId | string | |
icon | string | |
staterequired | string | Display (fleet-map) state of an agent |
status | string | |
model | string |
debugrequiredMesh manager internals (unstable)
Errors 401 · 403 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/mesh" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Enable mesh registration (persisted)
/network/mesh/enablePersists meshEnabled: true and re-registers the loaded agents. No body. With persist=0 the setting is left as it is.
Query parameters
| Name | Type | Description |
|---|---|---|
persist | string |
|
Responses
| Status | Description | Body | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Enabled | MeshToggleResponse | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
Errors 401 · 403 · 405 · 500 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 405 | Not available on this daemon (the subsystem is read-only or lacks this operation) | |
| 500 | Unexpected runtime failure | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/network/mesh/enable" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Disable mesh registration (persisted)
/network/mesh/disablePersists meshEnabled: false and unregisters mesh agents without unloading them. No body. With persist=0 the setting is left as it is.
Query parameters
| Name | Type | Description |
|---|---|---|
persist | string |
|
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Disabled | MeshToggleResponse |
Fields as in MeshToggleResponse above. | ||
Errors 401 · 403 · 405 · 500 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 405 | Not available on this daemon (the subsystem is read-only or lacks this operation) | |
| 500 | Unexpected runtime failure | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/network/mesh/disable" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Recent tool calls per mesh agent
/network/mesh/recent-toolsQuery parameters
| Name | Type | Description |
|---|---|---|
limit | integer | Calls per agent (default 5) |
Responses
| Status | Description | Body | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Recent calls | RecentMeshToolsResponse | ||||||||||||||||||
| ||||||||||||||||||||
Errors 400 · 401 · 403 · 405 · 503
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 405 | Not available on this daemon (the subsystem is read-only or lacks this operation) | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/mesh/recent-tools" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"This host's name and LAN addresses
/network/mesh/lan-addressesResponses
| Status | Description | Body | |||
|---|---|---|---|---|---|
| 200 | Addresses | LanAddressesResponse | |||
| |||||
Errors 401 · 403 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/mesh/lan-addresses" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Remote mesh runtimes discovered on the LAN
/network/mesh/discovered-runtimesQuery parameters
| Name | Type | Description |
|---|---|---|
force | string | Wait for a full scan (the refresh button): 1/true |
Responses
| Status | Description | Body | |||
|---|---|---|---|---|---|
| 200 | Runtimes (the daemon does not discover yet: empty) | DiscoveredRuntimesResponse | |||
| |||||
Errors 400 · 401 · 403 · 503
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/mesh/discovered-runtimes" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"The discovery feed: ADF computers on this network and the tailnet
/network/peersOne feed per computer (remote-access.md §5.1): the one _adf-runtime._tcp browser (plus the legacy _adf-daemon._tcp one for a release) and the one tailnet sweep. Each entry carries both capabilities: its mesh (when visible to other computers) and its remote access (when on). Studio's Discovered list and adf pair read it; the mesh peer list is its mesh half. Local-only: this machine's own clients with the local proof; a device token is refused (it would show the owner's view of the computers around this one). Keeps discovery running for a minute after the call. Changes are pushed to this computer's own sessions as remote_access {type: "peers_changed"}.
Query parameters
| Name | Type | Description |
|---|---|---|
wait | integer | Milliseconds to listen first, 0-5000 (a browser that just started hears answers) |
Responses
| Status | Description | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | The peers | object | |||||||||||||||||||||||||||||||||||||||||||||||||||
remoterequiredobject | null | Its remote access, when on: the tailnet address wins over the LAN one 6 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||
urlrequired | string | |
portrequired | integer | |
fingerprintrequired | string | |
pairingOpenrequired | boolean | |
kindrequired | string | |
clashrequired | integer | null | One fingerprint seen at this many addresses (more than one on the LAN or on the tailnet): each address is its own entry, never one replacing another; null when not |
Errors 400 · 401 · 403 · 503
| 400 | Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (statusCode, code, error, message).bad_requestFST_ERR_CTP_EMPTY_JSON_BODY | |
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/peers" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Mesh HTTP server status
/network/serverResponses
| Status | Description | Body | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Status | MeshServerStatus | |||||||||||||||
| |||||||||||||||||
Errors 401 · 403 · 405 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 405 | Not available on this daemon (the subsystem is read-only or lacks this operation) | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/server" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"{
"running": true,
"port": 7295,
"host": "127.0.0.1"
}Start the mesh HTTP server (persisted)
/network/server/startThe mesh server (port 7295 by default, separate from this API) serves agent cards, health, ALF inbox delivery and agent web/API routes under /agents/{handle}/*. It is on by default; this persists meshServerEnabled: true. No body. With persist=0 the setting is left as it is.
Query parameters
| Name | Type | Description |
|---|---|---|
persist | string |
|
Responses
| Status | Description | Body | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Started | MeshServerActionResponse | ||||||||||||||||||
| ||||||||||||||||||||
Errors 401 · 403 · 405 · 500 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 405 | Not available on this daemon (the subsystem is read-only or lacks this operation) | |
| 500 | Unexpected runtime failure | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/network/server/start" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Stop the mesh HTTP server (persisted)
/network/server/stopPersists meshServerEnabled: false, so it stays off across restarts until started again. No body. With persist=0 only the running server stops; the setting is left as it is.
Query parameters
| Name | Type | Description |
|---|---|---|
persist | string |
|
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Stopped | MeshServerActionResponse |
Fields as in MeshServerActionResponse above. | ||
Errors 401 · 403 · 405 · 500 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 405 | Not available on this daemon (the subsystem is read-only or lacks this operation) | |
| 500 | Unexpected runtime failure | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/network/server/stop" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Restart the mesh HTTP server
/network/server/restartNo body.
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Restarted | MeshServerActionResponse |
Fields as in MeshServerActionResponse above. | ||
Errors 401 · 403 · 405 · 500 · 503
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin | |
| 405 | Not available on this daemon (the subsystem is read-only or lacks this operation) | |
| 500 | Unexpected runtime failure | |
| 503 | The subsystem is not configured on this daemon |
Error bodies use the error format.
Example
curl -X POST "http://127.0.0.1:7385/network/server/restart" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Probe a peer agent’s /health
/network/peers/health5 s timeout.
Query parameters
| Name | Type | Description |
|---|---|---|
urlrequired | string | The peer agent’s health URL (http or https) |
Responses
| Status | Description | Body | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | PeerHealthResult | ||||||||||||
| ||||||||||||||
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/peers/health?url=URL" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Fetch a peer agent’s shared file
/network/peers/shared-file10 s timeout, 2 MB cap; binary content is base64.
Query parameters
| Name | Type | Description |
|---|---|---|
baseUrlrequired | string | The peer agent’s base URL |
pathrequired | string | Relative shared file path |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | OK | PeerSharedFileResult |
Errors 401 · 403
| 401 | Missing or wrong bearer token (unauthorized) | |
| 403 | The request guard refused it: Host header not allowed (host_not_allowed, DNS-rebinding protection) or a browser cross-site request (cross_origin)host_not_allowedcross_origin |
Error bodies use the error format.
Example
curl "http://127.0.0.1:7385/network/peers/shared-file?baseUrl=BASE_URL&path=PATH" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"