Skip to main content

​
Base URL

All endpoints are prefixed with /api/v1. 
http://localhost:8000/api/v1

​
Authentication

The Engine API currently does not require authentication. In production deployments, secure the API behind a reverse proxy or API gateway.

​
Endpoints

MethodEndpointDescription
GET/healthHealth check
GET/topology/graphFull topology graph
GET/topology/agents/{agent_id}Single agent detail
GET/sessionsSession list
GET/sessions/{trace_id}/spansSpans for a trace
GET/risk/agentsAll agents with risk data

​
Response Format

All endpoints return JSON. Errors return: 
{
  "detail": "Error description"
}
with the appropriate HTTP status code (400, 404, or 500).