Academics

Read Academics: one record by id, records of a type filtered by dates, course, term, status or text, view 'grades' for engine-computed grades and GPA, or with no filter a compact summary (counts, current courses, upcoming coursework). ALWAYS pass from/to when the question concerns a period. The ONLY correct source for grade and GPA answers.

Note: view 'grades' reads computed grades and GPA (courseId for one course); with no filter, counts, current courses and upcoming coursework.

{
  "view": "grades"
}

Add one record (set type): coursework (default; courseId + title + dueAt), a course (name + termId), a term (name + startDate + endDate), a study session (startAt + durationMinutes) or a degree plan (name). Due dates schedule reminders; grading categories and requirement lists replace whole when sent.

Note: Set type for a course, term, session or plan. gradingScheme categories and plan requirements replace whole when sent.

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

Change one record by record.id (set type for anything but coursework); sent fields merge. Record a grade (pointsEarned/pointsPossible, gradePercent or letterGrade marks it graded), a course's final grade, a new due date or status. Resolve the id with academics_find first.

Note: Entering a grade marks the item graded. Set type for a course, term, session or plan.

{
  "type": "coursework",
  "record": {
    "id": "cw_midterm1",
    "pointsEarned": 88,
    "pointsPossible": 100
  }
}

Delete (archive) one record (set type). A course takes its coursework (and grades) with it; a term keeps its courses, which still count toward the GPA as 'unassigned'. Only for explicit removals; resolve the id first and confirm intent.

Note: Set type for a course (its coursework goes too), a term (its courses stay), a session or a plan.