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: <token>

Response:

{
  "node_id": "uuid"
}

POST /v1/agent/discovery

Submit a new discovery snapshot (used during relearn).

Headers: X-Agent-Token: <token>

POST /v1/agent/runtime

Submit runtime metrics payload.

Headers: X-Agent-Token: <token>

GET /v1/agent/config

Fetch the runtime configuration for this node.

Headers: X-Agent-Token: <token>

Response:

{
  "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.