create_quiz
ChatGPTASYNC REVIEW FLOW (you write the quiz, the user answers it in the web app, you grade it later): 1. create_quiz — write the questions for a due topic. 2. The user answers them in their own time; you are not in that loop. 3. list_quizzes — poll for quizzes they have answered. 4. get_quiz — read their answers alongside the reference answers you wrote. 5. grade_quiz — score each answer, which records the review and deletes the quiz. Use this flow when the user is not in the conversation (a scheduled/cron run, or you are working ahead); use submit_review instead when you can quiz them live in chat. STEP 1 — write a quiz and put it in the user's quiz inbox. Base the questions on the topic's notes/content (get_topic) and mix formats: "single"/"multi" choice for recall, "text" for explanations, "code" for a Java exercise they can run in the browser. 3-6 questions is a good review. ALWAYS supply your reference answers — correct_options for choice questions, expected for text/code — they are stored server-side, are never shown to the user, and come back to you from get_quiz so you grade against what you actually meant days later. The topic must already be learned (mark_learned first), and only one quiz may be open per topic at a time. Nothing is graded and the review schedule does NOT move yet; the user is notified that a quiz is waiting. Do not wait for an answer — end your turn and check back later with list_quizzes.
create_subject
ChatGPTCreate a new subject (a course/grouping that topics can belong to).
create_topic
ChatGPTCreate a topic. Provide lesson material as Markdown in content_markdown (and optional notes_markdown). Set learned:false for "to learn" topics (kept out of the review queue until marked learned); learned:true (default) drops it straight into spaced-repetition using confidence (1-10, default 5). If parent_id is set, the topic inherits the parent's subject.
get_quiz
ChatGPTASYNC REVIEW FLOW (you write the quiz, the user answers it in the web app, you grade it later): 1. create_quiz — write the questions for a due topic. 2. The user answers them in their own time; you are not in that loop. 3. list_quizzes — poll for quizzes they have answered. 4. get_quiz — read their answers alongside the reference answers you wrote. 5. grade_quiz — score each answer, which records the review and deletes the quiz. Use this flow when the user is not in the conversation (a scheduled/cron run, or you are working ahead); use submit_review instead when you can quiz them live in chat. STEP 4 — read one quiz in full before grading it: every question in order, the expected / correct_options reference answers you wrote at step 1, and the user's answer to each (null until they answer; multi-select answers arrive as a JSON array string). Grade against your own reference answer, but credit a correct answer worded differently. Note each question's 0-based index — that is how you address it in grade_quiz.
get_topic
ChatGPTFetch a single topic in full, including summary, notes and lesson content (HTML).
grade_quiz
ChatGPTASYNC REVIEW FLOW (you write the quiz, the user answers it in the web app, you grade it later): 1. create_quiz — write the questions for a due topic. 2. The user answers them in their own time; you are not in that loop. 3. list_quizzes — poll for quizzes they have answered. 4. get_quiz — read their answers alongside the reference answers you wrote. 5. grade_quiz — score each answer, which records the review and deletes the quiz. Use this flow when the user is not in the conversation (a scheduled/cron run, or you are working ahead); use submit_review instead when you can quiz them live in chat. STEP 5 — grade an answered quiz and close the loop. Give every question a score from 0 (wrong) through 0.5 (partially right) to 1 (right), plus feedback written TO THE USER — say what was missing or what to remember, not just "correct". Every question index must appear exactly once; a partial grading is rejected rather than silently scoring the rest zero. This records the spaced-repetition review: your score is folded together with the confidence the user rated themselves, SM-2 advances, and the graded questions are stored in the topic's review history where the user reads your feedback. THE ASSIGNMENT IS DELETED ON SUCCESS — it vanishes from list_quizzes and must never be graded again. Grading a topic also clears its cached auto-generated quiz, so the user's next in-app review asks fresh questions.
list_due_reviews
ChatGPTList topics due for revision today or earlier (only learned topics), optionally filtered to a subject.
list_quizzes
ChatGPTASYNC REVIEW FLOW (you write the quiz, the user answers it in the web app, you grade it later): 1. create_quiz — write the questions for a due topic. 2. The user answers them in their own time; you are not in that loop. 3. list_quizzes — poll for quizzes they have answered. 4. get_quiz — read their answers alongside the reference answers you wrote. 5. grade_quiz — score each answer, which records the review and deletes the quiz. Use this flow when the user is not in the conversation (a scheduled/cron run, or you are working ahead); use submit_review instead when you can quiz them live in chat. STEP 3 — your work queue. Start a scheduled/cron run with this call. It defaults to status "answered": quizzes the user has filled in that are waiting for you to grade. Pass "pending" to see what they haven't answered yet (chase-up, or decide not to assign more), or "all" for both. Graded quizzes are deleted, so everything returned here is genuinely outstanding and an EMPTY LIST MEANS THERE IS NOTHING TO DO — stop, do not re-grade or re-assign anything.
list_subjects
ChatGPTList all of the user's subjects (course-level groupings of topics).
list_topics
ChatGPTList topics, optionally filtered to one subject. Returns compact summaries (no bodies).
mark_learned
ChatGPTMark a "to learn" topic as learned, seeding its spaced-repetition schedule from an initial confidence (1-10).
submit_review
ChatGPTRecord a spaced-repetition review for a learned topic that YOU (the model) quizzed and graded. The backend generates NO questions here — you write the questions, ask the user, judge their answers, then call this to log the result and advance the SM-2 schedule. Pass the user's self-rated confidence (1-10) and optionally quiz_score (0-1) plus the graded questions. The topic must already be learned (use mark_learned first). Use list_due_reviews to find topics that are due.
update_topic
ChatGPTUpdate an existing topic. Only the fields you pass are changed. Markdown fields replace the stored body. Changing parent_id re-files the topic (and inherits the parent's subject).