Skip to content
Docs

Learning & Credits

Alpha Learning

Enroll students in mastery curricula, read progress, award points, publish leaderboards.

Alpha Learning is Grout's two-hour mastery loop: a curriculum of concepts, daily plans, sessions and spaced review, with points, streaks and badges on top. The API exposes enrollment and progress so an LMS can show it or drive it.

Curricula#

bash
curl $API/alpha/curricula -H "Authorization: Bearer $KEY"        # published; institution-owned + shared

Enroll#

bash
curl -X POST $API/alpha/enrollments -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "curriculum_id": "cur_…", "student_ids": ["u_1", "u_2"], "daily_target_minutes": 120 }'
curl -X PATCH $API/alpha/enrollments/enr_… -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "status": "paused" }'
curl "$API/alpha/enrollments?student_id=u_1" -H "Authorization: Bearer $KEY"

Progress#

bash
curl $API/alpha/students/u_1 -H "Authorization: Bearer $KEY"             # drill-down
curl $API/alpha/students/u_1/mastery -H "Authorization: Bearer $KEY"     # per-concept score/status
curl $API/alpha/students/u_1/points -H "Authorization: Bearer $KEY"      # stats + ledger
curl "$API/alpha/leaderboard?limit=20" -H "Authorization: Bearer $KEY"

Award points#

bash
curl -X POST $API/alpha/students/u_1/points -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "points": 25, "note": "Science fair", "ref": "fair-2026" }'

±100 per call, idempotent on ref.

Events#

alpha.points_awarded, alpha.badge_granted. Guardians receive weekly reports; read them via GET /guardians/reports.

PreviousProctoring & AI PolicyNextMerits & Coupons