Skip to content
Docs

People & Access

Guardians

Invite parents to the Guardians portal and read their weekly reports.

A guardian is linked to a student, accepts an email invitation, then signs in to audit.grout.app with a one-time code. They see exams, grades, submissions and weekly Alpha reports — never proctoring recordings.

Invite#

bash
curl -X POST $API/guardians -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{
  "student_id": "u_…",
  "guardian_email": "[email protected]",
  "guardian_type": "mother",
  "guardian_name": "R. Rao",
  "is_primary": true
}'

guardian_type is father, mother or guardian. A student can have several guardians; 409 already_added if the pair exists.

Manage#

bash
curl "$API/guardians?student_id=u_…" -H "Authorization: Bearer $KEY"
curl "$API/guardians?verified=false" -H "Authorization: Bearer $KEY"      # still pending
curl -X POST $API/guardians/g_…/resend -H "Authorization: Bearer $KEY"
curl -X DELETE $API/guardians/g_… -H "Authorization: Bearer $KEY"

GET /students/{id}/guardians returns the same rows for one student.

Reports#

Weekly Alpha Learning reports are generated for each verified guardian:

bash
curl "$API/guardians/reports?since=2026-09-01T00:00:00Z" -H "Authorization: Bearer $KEY"

Events#

guardian.invited when a link is created; guardian.verified when the guardian first signs in. Neither carries the guardian's email.

PreviousSSO Launch (LMS)NextExams Overview