Certification BLoC

List all certification BLoC state entries

{
  "data": [
    {
      "id": "bloc-mentor-42",
      "mentor_id": "mentor-42",
      "cert_status": "active",
      "enrolled_course_ids": [
        "course-cert-renewal-101"
      ],
      "last_event": "RecordRenewalEvent",
      "last_event_at": "2026-03-26T08:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45
  }
}

Get current CertificationState stream snapshot for a mentor

{
  "mentor_id": "mentor-42",
  "cert_status": "active",
  "cert_type": "peer_mentor_level_2",
  "issued_at": "2026-03-01T00:00:00Z",
  "expires_at": "2027-03-01T00:00:00Z",
  "enrolled_course_ids": [
    "course-cert-renewal-101"
  ],
  "event_history": [
    {
      "event": "LoadCertificationEvent",
      "fired_at": "2026-03-26T07:00:00Z"
    },
    {
      "event": "EnrolInCourseEvent",
      "fired_at": "2026-03-26T07:05:00Z"
    }
  ]
}

Emit an event into the BLoC (LoadCertificationEvent, RecordRenewalEvent, EnrolInCourseEvent)

{
  "mentor_id": "mentor-42",
  "event_type": "EnrolInCourseEvent",
  "payload": {
    "course_id": "course-cert-renewal-101"
  }
}

{
  "id": "evt-bloc-0091",
  "mentor_id": "mentor-42",
  "event_type": "EnrolInCourseEvent",
  "payload": {
    "course_id": "course-cert-renewal-101"
  },
  "processed": true,
  "new_state": {
    "cert_status": "active",
    "enrolled_course_ids": [
      "course-cert-renewal-101"
    ]
  },
  "created_at": "2026-03-26T10:00:00Z"
}

Replay or retry a BLoC event

{
  "retry": true
}

{
  "id": "evt-bloc-0091",
  "retried": true,
  "processed": true,
  "updated_at": "2026-03-26T10:10:00Z"
}

Remove a BLoC event from history

{
  "deleted": true,
  "id": "evt-bloc-0091"
}

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