CanQuiz

Records the person's answer to the question of a turn. With options: choices are the letters chosen ([] for I don't know) and CanQuiz decides if it was right; guessed true when the person says they guessed, which counts a right answer as partly known. Own-words questions (kind open): a first call with answer returns the solution and saves nothing; a second call with self_grade records it. Returns the result, the correct answer, the explanation and when it comes back.

answer_question

Used by the CanQuiz practice card: records an answer, or changes I guessed on an answered turn.

ui_answer_question

Changes a quiz's title, description or questions. Operations apply in order, all or none: add (at the end or after a question id), change (only the fields sent), remove. version comes from get_quiz; quiz_changed means it changed since, and nothing was applied. A quiz cannot be left without questions.

edit_quiz

Saves a new private quiz in the person's account, after CanQuiz checks every question. Up to 100 questions per call; add more with edit_quiz. Options-based questions have 4 options; correct is the exact option text. The same call repeated within 10 minutes returns the same quiz (already_existed).

create_quiz

Deletes a folder; it cannot be undone. Its quizzes stay in the account, outside any folder; the sources uploaded to it are deleted with it. name must match the folder name exactly, or nothing is deleted (name_mismatch).

delete_folder

Lists the person's folders with how many quizzes each has and its exam date.

list_folders

Lists the person's quizzes, most recently changed first, 20 per page, with folder and exam date. Use this to find a quiz id. query filters by title words; folder_id lists one folder. next_offset means more remain.

list_quizzes

Puts a quiz in a folder, given by folder_id or by folder_name (a new folder is created when none has that name), or takes it out of its folder with folder_id null. The quiz takes the folder's exam date unless it has its own.

move_to_folder

Serves the next practice question of a quiz or a folder, without its answer: due (questions due today), mistakes (to fix), new (never practised) or all (the default: due first, then mistakes, new and the rest). Use this to practise in the chat. Pass back round to continue the round: a question served in a round does not come back in it. has_question false means the round is over; calling without round starts a new one. Practice is turned on for the quiz if it was off.

next_question

Used by the CanQuiz practice card: the next question of the round, skipping the turns already played.

ui_next_question