Academics

Add a term (semester/quarter) or update one. Omit record.id to create (name + startDate + endDate required); include a real record.id to update, sent fields merge.

{
  "record": {
    "name": "Fall 2026",
    "level": "undergrad",
    "startDate": "2026-08-24",
    "endDate": "2026-12-11",
    "status": "active"
  }
}

Delete (archive) one term. Courses and coursework in it are NOT removed: they keep their grades, still count toward the cumulative GPA, and are reported as 'unassigned' until they are moved to another term or deleted. Only for explicit removals; confirm intent.

List terms, courses, coursework, grade scales, study sessions, and degree plans. Use for schedule/due-date/status questions and to resolve IDs before any write. Defaults to a compact summary: counts plus current courses and upcoming open coursework. For grade or GPA questions use academics_queryGrades instead.

Add a course or update one (grading scheme, credits, status, target grade, costs). Omit record.id to create (name + termId required); include a real record.id to update. gradingScheme replaces the whole scheme when sent.

Note: gradingScheme replaces the whole scheme when sent.

{
  "record": {
    "termId": "term_fall26",
    "name": "Linear Algebra",
    "code": "MATH 221",
    "creditHours": 4,
    "status": "enrolled"
  }
}

Delete (archive) one course AND its coursework, grades leave the transcript. Only for explicit removals; confirm intent.

Add an assignment or exam, update one, or record its grade (pointsEarned/pointsPossible, gradePercent, or letterGrade, grade entry marks it graded). Omit record.id to create (courseId + title + dueAt required). Due dates schedule reminders.

{
  "record": {
    "courseId": "course_math221",
    "kind": "exam",
    "title": "Midterm 1",
    "type": "midterm",
    "dueAt": "2026-10-14T10:00:00-05:00",
    "pointsPossible": 100
  }
}

Delete (archive) one assignment or exam and clear its reminder. Only for explicit removals, resolve the ID first.

Log a study session (start time + duration, optionally course/topic/focus). Feeds weekly study stats and any linked study-hours Goal.

{
  "record": {
    "courseId": "course_math221",
    "startAt": "2026-09-26T19:00:00-05:00",
    "durationMinutes": 50,
    "technique": "pomodoro",
    "topic": "Eigenvalues"
  }
}

Create or update a degree plan (degree type, total credits, expected graduation, and requirement buckets with the courses that satisfy them). Omit record.id to create (name required); include a real record.id from the dashboard to update. requirements replaces the whole list when sent.

Note: requirements replaces the whole list when sent.

Delete (archive) one degree plan. Only for explicit removals, resolve the ID with academics_queryAcademicsDashboard first.

Engine-computed grades and GPA for ONE student. Defaults to the account owner's own summary: cumulative GPA plus each term's GPA and credits. Pass courseId for one course's percent/letter/breakdown, termId to scope to a term, subjectPersonId for a family member's transcript, or detail:'full' for the whole transcript. The ONLY correct source for grade and GPA answers, never compute them from raw coursework.