Skip to main content
Mole managing agents

Agent Endpoints

Remote agent status and management.

GET /agents​

List all known agents in the mesh.

Response:

{
  "agents": [
    {
      "id": "abc123...",
      "display_name": "Agent 1",
      "last_seen": "2025-01-01T00:00:00Z"
    }
  ]
}

GET /agents/{agent-id}​

Get status from specific agent.

Response:

{
  "id": "abc123...",
  "display_name": "Agent 1",
  "uptime": 3600,
  "peers": 3,
  "streams": 42,
  "routes": 5
}

GET /agents/{agent-id}/routes​

Get route table from specific agent.

Response:

{
  "routes": [
    {
      "cidr": "10.0.0.0/8",
      "next_hop": "def456...",
      "metric": 1,
      "ttl": 300
    }
  ]
}

GET /agents/{agent-id}/peers​

Get peer list from specific agent.

Response:

{
  "peers": [
    {
      "id": "def456...",
      "address": "192.168.1.20:4433",
      "transport": "quic",
      "connected": true
    }
  ]
}

POST /agents/{agent-id}/rpc​

Execute RPC command on remote agent.

See RPC Endpoints.

POST /agents/{agent-id}/file/upload​

Upload file to remote agent.

See File Transfer Endpoints.

POST /agents/{agent-id}/file/download​

Download file from remote agent.

See File Transfer Endpoints.