API Reference
Quality
Ingest quality signals and retrieve accuracy data via the REST API.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Ingest quality signals and retrieve accuracy data via the REST API.
POST /api/v1/jobs/{job_id}/quality
{
"agent_id": "invoice-processor-v2",
"job_id": "job-20240315-001",
"overall_passed": true,
"token_input": 1247,
"token_output": 312,
"model": "gpt-4o",
"latency_ms": 1840,
"checks": [
{
"check_id": "output_not_empty",
"severity": "HIGH",
"passed": true
},
{
"check_id": "subtotal_arithmetic",
"severity": "HIGH",
"passed": true,
"expected": "1234.56",
"actual": "1234.56",
"delta": "0.00"
}
]
}
{
"signal_id": "uuid",
"agent_id": "uuid",
"job_id": "job-20240315-001",
"overall_passed": true,
"check_count": 2,
"passed_count": 2,
"received_at": "2026-03-24T10:00:00Z"
}
GET /api/v1/agents/{agent_id}/signals?limit=50
GET /api/v1/agents/{agent_id}/accuracy?days=30
[
{
"check_id": "subtotal_arithmetic",
"severity": "HIGH",
"agg_date": "2026-03-24",
"total_runs": 85,
"passed_runs": 72,
"pass_rate": 0.847,
"trend": "DEGRADING"
}
]
GET /api/v1/optimise/heatmap?window_days=30&severity=ALL