API Reference

Endpoints, transports, and tools.

OpenAPI specs ship with each service in the repository. This page summarizes the public surface.

Ingest (OTLP)

https://ingest.<region>.signalcortex.ai x-api-key, x-signalcortex-key or Authorization: Bearer
  • POST /v1/logs OTLP HTTP logs (JSON or protobuf; gzip, zstd or snappy; up to 64 MiB). 429 + Retry-After above the plan's rate.
  • POST /v1/traces OTLP HTTP traces (JSON or protobuf; gzip, zstd or snappy; up to 64 MiB).
  • POST /v1/metrics OTLP HTTP metrics (JSON or protobuf; gzip, zstd or snappy; up to 64 MiB).
  • POST /v1/evaluations Batch of up to 1000 offline or CI evaluation results (JSON); returns accepted, rejected and per-item errors.
  • POST /v1/verify Checks an API key without sending data: 200 with the tenant, 401 unknown or inactive, 403 wrong region.
  • gRPC :443 OTLP gRPC for logs, traces and metrics on the same regional host. The original otlp.signalcortex.ai:4317 (gRPC) and :4318 (HTTP) keep working.

Query API

https://api.signalcortex.ai X-API-Key
  • GET /api/v1/logs/search Search logs by service, severity, and free-text body.
  • GET /api/v1/spans/search Search spans by service, name, and attributes.
  • GET /api/v1/traces/{id} Fetch a full nested-span tree by trace ID.
  • GET /api/v1/metrics/series Time-series metric points by name and label filters.
  • GET /healthz Unauthenticated health check.

MCP server (clickhouse-mcp)

https://mcp.signalcortex.ai X-API-Key (Streamable HTTP transport)
  • TOOL search_logs · search_spans · search_traces · get_trace Core observability search tools.
  • TOOL list_anomalies · get_anomaly_baseline · search_anomaly_correlation Anomaly detection tools.
  • TOOL search_evaluation_results · evaluation_summary · evaluation_regression · evaluation_comparison Quality and release tools.
  • TOOL search_reasoning_steps · reasoning_token_usage · reasoning_quality_analysis Reasoning trace tools.
  • TOOL get_agent_map · search_agent_edges · fleet_health_summary · fleet_top_failing · fleet_activity_feed Agent topology and fleet overview.

Persona router

https://api.signalcortex.ai JWT bearer (Keycloak / Entra ID)
  • GET /personas List personas the caller is entitled to.
  • POST /sessions Create a persona-bound chat session.
  • GET /sessions/{id}/stream SSE stream for chat tokens, tool calls, and approvals.
  • POST /sessions/{id}/messages Send a user message into the active session.
  • GET /anomalies/stream Persona-filtered anomaly event stream (SSE).