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"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}