credit-registration-admin

POST `/api/v0/main-frontend/credit-registration-admin/account-linking/resend` - Sets off another account-linking mail for one person on one course. The mail goes to the addresses the study registry holds, and the recipient still has to open the link while signed in, so the ownership proof is intact. An override does not ask a cap for an exemption: it retires the ledger rows the cap is counting, as its own audited action, then runs the ordinary path.

Changed on
post/api/v0/main-frontend/credit-registration-admin/account-linking/resend

Request

  • The document declares no server URL.
  • Auth: none declared

Request body

course_idstring uuid required
credit_registration_idstring uuid nullable

The registration whose student the mail is a guess for, from the linking candidates. Must be on course_id; recorded on the audit row.

override_rate_capsboolean required

Retires the mails a cap is counting, then runs the ordinary send path. Requires a reason.

reasonstring nullable
student_numberstring required

Response

What the attempt did

mails_sent_for_this_courseinteger required
max_mails_per_person_and_courseinteger required
outcome'queued' | 'already_mailed_to_every_known_address' | 'refused_by_rate_cap' | 'no_address_in_study_registry' | 'not_on_the_course_roster' | 'already_linked' | 'study_registry_unavailable' | 'no_student_number_known' required

What a resend endpoint tells its caller. Shared wire shape for the teacher- and admin-facing resend endpoints; NoStudentNumberKnown is only ever emitted by the teacher endpoint, whose target may be an account that has never held a number.

quiet_period_secsinteger required
retired_mail_countinteger required

Mails retired to get past a cap. Always zero without an override.

Changes