Skip to content

09. Dashboard API

Lav edited this page Mar 30, 2026 · 1 revision

Dashboard API

When running with infraguard dashboard, the following REST API is available:

Endpoint Method Description
/api/stats GET Overview statistics (last 24h by default, ?hours=N)
/api/requests GET Recent request log (?limit=50&domain=...)
/api/stats/content GET Content delivery statistics (?hours=24)
/api/nodes GET List registered redirector nodes
/api/nodes/register POST Register a new node
/api/nodes/{id}/heartbeat POST Update node heartbeat
/api/intel/classify POST Classify an IP address ({"ip": "1.2.3.4"})
/api/intel/blocklist POST Add CIDRs to blocklist ({"cidrs": ["1.2.3.0/24"]})
/api/config GET Current configuration (sanitized)
/api/config/domains GET List configured domains
/api/decoys GET List decoy files per domain
/api/decoys/{domain}/{file} GET Read a decoy file
/api/decoys/{domain}/{file} PUT Update a decoy file ({"content": "..."})
/ws/events WS Real-time event stream (WebSocket)

All API endpoints require an Authorization: Bearer <token> header when auth_token is configured.

Clone this wiki locally