Badge Criteria Edge Function - API Contract

REST /api/v1/badge-criteria 1 endpoint

POST /api/v1/badge-criteria/api/v1/badge-criteria/evaluate

Edge function entry point — receives event payload (e.g. session completed, training finished), extracts peer mentor context, triggers evaluation, and returns awarded badges

Auth Required system

Request Example

{
  "event_type": "session_completed",
  "payload": {
    "peer_mentor_id": "pm-kari-001",
    "organisation_id": "org-nhf-oslo",
    "session_id": "sess-20260326-kari",
    "completed_at": "2026-03-26T16:00:00Z"
  }
}

Response Example

{
  "peer_mentor_id": "pm-kari-001",
  "organisation_id": "org-nhf-oslo",
  "event_type": "session_completed",
  "evaluated_at": "2026-03-26T16:00:12Z",
  "awarded_badges": [
    {
      "id": "earned-017",
      "badge_definition_id": "bdg-def-004",
      "badge_name": "10 Sessions",
      "icon_url": "https://assets.example.com/badges/10-sessions.svg",
      "awarded_at": "2026-03-26T16:00:12Z"
    }
  ],
  "total_awarded": 1
}

Additional Metadata

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