Skip to content

API Reference

Complete API reference for all StrataRouter Runtime interfaces.

REST API

Execute Endpoint

POST /api/v1/execute
Content-Type: application/json

{
  "query": "Where's my invoice?",
  "context": {
    "user_id": "123"
  }
}

Response:

{
  "response": "Your invoice is...",
  "route_id": "billing",
  "confidence": 0.94,
  "latency_ms": 45,
  "cost_usd": 0.002
}

Route Endpoint

POST /api/v1/route
Content-Type: application/json

{
  "query": "My payment failed",
  "embedding": [0.1, 0.2, ...]
}

Health Check

GET /api/v1/health

Response:

{
  "status": "healthy",
  "version": "0.1.0"
}

Metrics

GET /api/v1/metrics

gRPC API

service StrataRouterRuntime {
  rpc Execute(ExecuteRequest) returns (ExecuteResponse);
  rpc Route(RouteRequest) returns (RouteResponse);
  rpc GetMetrics(Empty) returns (MetricsResponse);
}

message ExecuteRequest {
  string query = 1;
  map<string, string> context = 2;
}

message ExecuteResponse {
  string response = 1;
  string route_id = 2;
  float confidence = 3;
  double latency_ms = 4;
  double cost_usd = 5;
}

Runtime Index