Scenario Evaluation Edge Function
API Contract
REST
/api/v1/edge-evaluations
6 endpoints
GET
/api/v1/edge-evaluations/api/v1/edge-evaluations
List edge function evaluation invocations with outcome summaries
Public
Response Example
{
"data": [
{
"id": "edge_e1f2a3",
"trigger_type": "scheduled",
"invoked_at": "2026-03-26T06:00:00Z",
"duration_ms": 5821,
"triggered_count": 7,
"dispatched_count": 7,
"status": "success"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 90
}
}
GET
/api/v1/edge-evaluations/api/v1/edge-evaluations/:id
Fetch detailed result for a single edge function invocation
Public
Response Example
{
"id": "edge_e1f2a3",
"trigger_type": "scheduled",
"invoked_at": "2026-03-26T06:00:00Z",
"duration_ms": 5821,
"triggered_count": 7,
"dispatched_count": 7,
"errors": [],
"summary": {
"chapters_processed": 3,
"activities_evaluated": 38,
"prompts_sent": 7
},
"status": "success"
}
POST
/api/v1/edge-evaluations/api/v1/edge-evaluations
Manually invoke the edge evaluation function (maps to handleScheduledTrigger)
Public
Request Example
{
"trigger_type": "manual",
"since": "2026-03-25T06:00:00Z",
"chapter_ids": [
"ch_boston_001",
"ch_denver_007"
]
}
Response Example
{
"id": "edge_b4c5d6",
"trigger_type": "manual",
"invoked_at": "2026-03-26T09:10:00Z",
"duration_ms": 4310,
"triggered_count": 3,
"dispatched_count": 3,
"errors": [],
"status": "success"
}
PUT
/api/v1/edge-evaluations/api/v1/edge-evaluations/:id
Update an edge evaluation record (e.g. add notes, mark reviewed)
Public
Request Example
{
"review_note": "Confirmed prompts were dispatched correctly. No anomalies.",
"reviewed_by": "usr_admin_01"
}
Response Example
{
"id": "edge_e1f2a3",
"review_note": "Confirmed prompts were dispatched correctly. No anomalies.",
"reviewed_by": "usr_admin_01",
"reviewed_at": "2026-03-26T11:00:00Z"
}
DELETE
/api/v1/edge-evaluations/api/v1/edge-evaluations/:id
Delete an edge evaluation invocation record
Public
Response Example
{
"deleted": true,
"id": "edge_e1f2a3"
}
GET
/api/v1/edge-evaluations/api/v1/edge-evaluations/health
Check edge function health and last successful invocation time
Public
Response Example
{
"healthy": true,
"last_successful_run_at": "2026-03-26T06:00:00Z",
"last_run_status": "success",
"next_scheduled_at": "2026-03-27T06:00:00Z"
}