Network · Daemon API

On this page

Network diagnostics (host, mesh, WebSockets, agents)

GET/network

Operation getNetworkDiagnosticsAuthBearer token

Responses

Status Description Body

200 Diagnostics NetworkDiagnostics

hostrequired object

2 fields of host · LanAddressInfo

hostnamerequired string

addressesrequired array<object>

4 fields of addresses

`iface`required	string
`address`required	string
`family`required	string	One of `IPv4`, `IPv6`
`mac`required	string

meshrequired object

4 fields of mesh

enabledSettingrequired boolean

lanrequired boolean

portrequired integer

statusrequired MeshStatus | null

5 fields of status

meshEnabledrequired boolean

meshServerRunningrequired boolean

meshServerrequired object

3 fields of meshServer · MeshServerStatus

`running`required	boolean
`port`required	integer
`host`required	string

agentsrequired array<MeshAgentStatus>

8 fields of agents

`filePath`required	string
`handle`required	string
`did`	string
`agentId`	string
`icon`	string
`state`required	string	Display (fleet-map) state of an agent One of `active`, `idle`, `hibernate`, `suspended`, `off`
`status`	string
`model`	string

debugrequired

object

Mesh manager internals (unstable)

websocketrequired object

3 fields of websocket

`activeConnections`required	integer
`inboundConnections`required	integer
`outboundConnections`required	integer

agentsrequired array<object>

10 fields of agents

`agentId`required	string
`handle`	string
`name`required	string
`filePath`required	string \| null
`receive`required	boolean
`sendMode`required	string \| null
`network`required	string \| null
`wsConnectionsConfigured`required	integer
`servingRoutes`required	integer
`publicServingEnabled`required	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

Request

curl "http://127.0.0.1:7385/network" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Network diagnostics (same as GET /network)

GET/runtime/network

Operation getRuntimeNetworkAuthBearer token

Responses

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

Request

curl "http://127.0.0.1:7385/runtime/network" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Live mesh status

GET/network/mesh

Operation getMeshStatusAuthBearer token

Responses

Status Description Body

200 Mesh status MeshStatus

meshEnabledrequired boolean

meshServerRunningrequired boolean

meshServerrequired object

3 fields of meshServer · MeshServerStatus

`running`required	boolean
`port`required	integer
`host`required	string

agentsrequired array<MeshAgentStatus>

8 fields of agents

`filePath`required	string
`handle`required	string
`did`	string
`agentId`	string
`icon`	string
`state`required	string	Display (fleet-map) state of an agent One of `active`, `idle`, `hibernate`, `suspended`, `off`
`status`	string
`model`	string

debugrequired

object

Mesh 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

Request

curl "http://127.0.0.1:7385/network/mesh" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Enable mesh registration (persisted)

POST/network/mesh/enable

Operation enableMeshAuthBearer token

Persists meshEnabled: true and re-registers the loaded agents. No body.

Responses

Status Description Body

200 Enabled MeshToggleResponse

successrequired boolean

meshEnabledrequired boolean

agentsrequired array<MeshAgentStatus>

8 fields of agents

`filePath`required	string
`handle`required	string
`did`	string
`agentId`	string
`icon`	string
`state`required	string	Display (fleet-map) state of an agent One of `active`, `idle`, `hibernate`, `suspended`, `off`
`status`	string
`model`	string

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

Request

curl -X POST "http://127.0.0.1:7385/network/mesh/enable" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Disable mesh registration (persisted)

POST/network/mesh/disable

Operation disableMeshAuthBearer token

Persists meshEnabled: false and unregisters mesh agents without unloading them. No body.

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

Request

curl -X POST "http://127.0.0.1:7385/network/mesh/disable" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Recent tool calls per mesh agent

GET/network/mesh/recent-tools

Operation getRecentMeshToolsAuthBearer token

Query parameters

Name	Type	Description
`limit`	integer	Calls per agent (default 5)

Responses

Status Description Body

200 Recent calls RecentMeshToolsResponse

toolsrequired

map<string, array<object>>

By agent handle

4 fields of tools

`name`required	string
`args`	string
`isError`	boolean
`timestamp`required	integer

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

Request

curl "http://127.0.0.1:7385/network/mesh/recent-tools" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

This host's name and LAN addresses

GET/network/mesh/lan-addresses

Operation getLanAddressesAuthBearer token

Responses

Status Description Body

200 Addresses LanAddressesResponse

addressesrequired

object

Fields as in LanAddressInfo above.

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

Request

curl "http://127.0.0.1:7385/network/mesh/lan-addresses" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Remote mesh runtimes discovered on the LAN

GET/network/mesh/discovered-runtimes

Operation getDiscoveredRuntimesAuthBearer token

Responses

Status Description Body

200 Runtimes (the daemon does not discover yet: empty) DiscoveredRuntimesResponse

runtimesrequired array<object>

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

Request

curl "http://127.0.0.1:7385/network/mesh/discovered-runtimes" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Mesh HTTP server status

GET/network/server

Operation getMeshServerStatusAuthBearer token

Responses

Status Description Body

200 Status MeshServerStatus

`running`required	boolean
`port`required	integer
`host`required	string

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

Request

curl "http://127.0.0.1:7385/network/server" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Response 200

{
  "running": true,
  "port": 7295,
  "host": "127.0.0.1"
}

Start the mesh HTTP server (persisted)

POST/network/server/start

Operation startMeshServerAuthBearer token

The 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.

Responses

Status Description Body

200 Started MeshServerActionResponse

`success`required	boolean
`running`required	boolean
`port`required	integer
`host`required	string

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

Request

curl -X POST "http://127.0.0.1:7385/network/server/start" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Stop the mesh HTTP server (persisted)

POST/network/server/stop

Operation stopMeshServerAuthBearer token

Persists meshServerEnabled: false, so it stays off across restarts until started again. No body.

Responses

Status Description Body

200 Stopped MeshServerActionResponse

`success`required	boolean
`running`required	boolean
`port`required	integer
`host`required	string

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

Request

curl -X POST "http://127.0.0.1:7385/network/server/stop" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Restart the mesh HTTP server

POST/network/server/restart

Operation restartMeshServerAuthBearer token

No body.

Responses

Status Description Body

200 Restarted MeshServerActionResponse

`success`required	boolean
`running`required	boolean
`port`required	integer
`host`required	string

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

Request

curl -X POST "http://127.0.0.1:7385/network/server/restart" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"