Command Palette

Search for a command to run...

Operations

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 chat permission

  • The 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 fine

  • 404 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

Requestbash
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"}'
Responsejson
{
  "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 read permission

  • status is one of pending, verifying, completed, rejected

  • due_at is when we have committed to finishing

  • 404 if that student has never had a request

Student Data Deletion | Math AI Docs