Student Data Deletion
Request erasure of one student's data, and check the state of that request.
Who deletes what
Math AI stores the conversations your students have with the tutor, so if one of them asks to be forgotten, the data is here and the erasure has to happen here. You are the only party who can connect an external_user_id back to a person, so you are the only one who can tell us which student that is.
We hold no names or email addresses for your students — only the opaque id you send us. That is deliberate: it keeps Math AI a processor acting on your instructions rather than a controller of your users' personal data.
Please keep it that way. Do not put a name, email address, phone number or anything else personally identifying into external_user_id or any other field. Send an opaque identifier that only your system can resolve to a person. If identifying data reaches us, both of us take on obligations neither of us planned for, and your erasure requests stop being a simple matter of deleting rows against an id.
Requires an API key with the
chatpermissionThe tenant comes from your API key — you can only ever name your own students
Filing a request does not delete anything immediately; see below
POST /students/{external_user_id}/deletion-request
Records the request and starts a 30-day clock. Erasure is a separate, deliberate step: we verify first, and an endpoint that wiped a student's history synchronously would be a dangerous thing to put behind a single API call.
Calling it twice is safe. If a request is already open you get that one back with meta.already_open, not an error and not a second entry in the queue.
An optional JSON body may carry
reason; no body is also fine404 if the external_user_id is not one of your students
201 with the created request, or 200 if one was already open
Usage totals are kept in de-identified aggregate form for accounting — the student is no longer identifiable in them
curl -s -X POST 'https://ai.zabai.org/api/external/v1/students/student-123/deletion-request' \
-H 'Authorization: Bearer $MATH_AI_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"reason": "Student exercised right to erasure"}'{
"success": true,
"request_id": "...",
"data": {
"id": "7f3c...",
"external_user_id": "student-123",
"status": "pending",
"requested_at": "2026-10-20T06:11:04.218Z",
"due_at": "2026-11-19T06:11:04.218Z"
}
}GET /students/{external_user_id}/deletion-request
Returns the most recent request for that student, so you can show your own users where things stand.
Requires an API key with the
readpermissionstatusis one of pending, verifying, completed, rejecteddue_atis when we have committed to finishing404 if that student has never had a request