API Reference
The API is intentionally narrow: authenticate, evaluate, report outcome, inspect history, and trace sessions. For full request and response shapes, see the integration guide.
Authentication
Kernel also supports WorkOS SSO for team-based access control on hosted deployments.
Evaluation
Evaluate a single action. Inputs: agent_id, session_id, action_type, amount, metadata.
Evaluate multiple actions in a single request. Useful for batch or replay workflows.
Outcome & History
Report the outcome after execution or review. Status, resolution, and optional impact metadata.
Add operator notes to an evaluation record.
Export evaluation records in CSV format for audit and analysis.
Investigations
List evaluations pending review or requiring attention. Supports query parameters for filtering.
Return the full session trail for a specific investigation.
Retrieve operator actions and configuration changes for compliance review.
Agents & Sessions
Register a new agent for tracking and evaluation.
Retrieve agent details and evaluation history.
Register a new session for an agent. Optional session-level metadata.
Configuration
Retrieve current configuration including thresholds, signals, and taxonomy.
Update configuration. Every change is versioned and audited.
Health & Metrics
Returns service status including version, uptime, database health, schema version, and authentication configuration.
Kubernetes liveness probe. Returns 200 when the process is alive.
Kubernetes readiness probe. Returns 200 when the service can accept traffic.
Returns a JSON snapshot of current evaluation and signal metrics.
Prometheus-formatted metrics for integration with monitoring stacks.
Dashboard
Aggregated summary statistics for the dashboard UI.
For full request bodies, response shapes, and implementation guidance, use the integration guide.