# Guardians

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

Canonical: https://grout.app/developer/documentation/people/guardians/

A guardian is linked to a student, accepts an email invitation, then signs in to [audit.grout.app](https://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": "parent@example.com",
  "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.