# API Reference Base URL: `https://api.moniqo.dev` ## Authentication Agent endpoints use the `X-Agent-Token` header. UI endpoints use session/JWT authentication. ## Agent Endpoints ### POST /v1/agent/register Register a new node and submit the initial discovery payload. **Headers:** `X-Agent-Token: ` **Response:** ```json { "node_id": "uuid" } ``` ### POST /v1/agent/discovery Submit a new discovery snapshot (used during relearn). **Headers:** `X-Agent-Token: ` ### POST /v1/agent/runtime Submit runtime metrics payload. **Headers:** `X-Agent-Token: ` ### GET /v1/agent/config Fetch the runtime configuration for this node. **Headers:** `X-Agent-Token: ` **Response:** ```json { "state": "active", "check_interval_sec": 60, "monitored_mounts": ["/", "/data"], "monitored_services": ["nginx", "mysql"], "send_dmesg": true } ``` ## Node Endpoints ### GET /v1/nodes List all nodes for the organization. ### GET /v1/nodes/:id Get node detail with profile and capabilities. ### POST /v1/nodes/:id/snapshot Request a full discovery snapshot from the agent. ## Alert Endpoints ### GET /v1/alerts List open incidents. ### POST /v1/alerts/:id/ack Acknowledge an incident.