API Specification

Agent Endpoints

POST /v1/agent/register

Register node and submit initial discovery payload.

POST /v1/agent/discovery

Submit new discovery snapshot (relearn).

POST /v1/agent/runtime

Submit runtime metrics payload.

GET /v1/agent/config

Fetch runtime configuration for this node.

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 snapshot from the agent.

Alert Endpoints

GET /v1/alerts

List open incidents.

POST /v1/alerts/:id/ack

Acknowledge an incident.