Flash

Use this when the user wants more new cards today than the daily limit allows ('give me 10 more new cards today'). Adds extra new cards for today only: to one deck, or without a deck to the account-wide allowance. Each call adds more, up to 500, and returns the total extra granted today. To change the limit for every day, use set_limits.

boost_new_today

Used by Flash's panel only; never call it yourself (use list_cards). Returns more of the cards the panel is paging through, both sides.

panel_cards

Use this when the user asks to rename a deck, nest it under another, or pull it out to the top level. new_name is the full path: Pharm::Cardio moves Cardio into Pharm (created if missing). Its subdecks, cards and review history follow. Refused if a deck already has that name (decks are never merged) or the target is inside the deck itself.

rename_deck

Use this when the user wants an earlier version of a card back, for example after an edit they did not want. Every edit keeps the text it replaced. Give card_id alone to list the card's earlier versions, newest first, and confirm with the user which one; then call again with its revision_id. A restore rewrites the card's source and its sibling cards in place, keeping their schedules and review history, and keeps the text it replaces too. A restore that would remove cards is refused.

restore_cards

Use this when the user wants to change how many new cards or reviews they get per day, for every deck or for one, or gives the date they need to know a deck by (an exam, a test, a deadline): goal_date paces that deck toward it. Without a deck it sets the account defaults; with a deck it sets that deck's override (-1 clears it so the deck inherits the account default). Omitted fields are left unchanged. For extra new cards today only, use boost_new_today.

set_limits

Use this when the user gives up on the card just asked in a study session, or asks for its answer. Returns the card's back and records nothing: tell the user the answer, then call submit_review with rating 1 (Again). To read whole cards outside a session, use list_cards.

show_answer

Use this when the user wants to study, review, practice, be quizzed on or drill their flashcards, including cards made moments ago. Starts a spaced-repetition session over the cards due now: all of them, one deck (with its subdecks), or the cards carrying every given tag (list_tags has the names). Progress counts only for cards asked here and graded with submit_review, so ask each card from this session, never from the conversation. To make new cards use create_cards. Returns the first card's front (ask it and wait for the user's answer), how many cards are due, and grading_mode. Render front_html for display or interpret it for speech; present cloze gaps without revealing answers, and never read raw markup or URLs aloud. Fetch media URLs with the connector Bearer token if needed. Follow grading_mode for the whole session. Internal fields (ids, counts) are never read aloud.

start_study_session

Used by Flash's study panel only; never call it yourself. Takes the card on screen out of study after the user tapped Archive (or puts it back on Undo) and returns the panel's next card.

panel_archive

Used by Flash's study panel only; never call it yourself (use list_cards). Returns the two fields behind a card for the panel's quick edit.

panel_edit_source

Used by Flash's study panel only; never call it yourself (use submit_review). Records the grade the user tapped and returns the panel's next card.

panel_grade

Used by Flash's study panel only; never call it yourself. Turns on reminders when cards are due, at this time of day, after the user tapped the panel's offer; with decline, stops the offer after the user tapped Not now.

panel_reminders

Used by Flash's study panel only; never call it yourself (use update_cards). Saves the panel's quick edit of a card's two fields and returns the card as it now reads.

panel_save_edit

Used by Flash's study panel only; never call it yourself (use show_answer). Returns a card's back for the panel.

panel_show_answer

Use this after the user answers the card just asked in a study session: records how well they knew it, which sets when the card comes back, and returns the next card. Grade STRICTLY against the card's back: facts, numbers, doses, and units must match precisely. An imprecise answer is 1 (Again), never 'close enough'; only phrasing may differ. Part of an answer is a miss, so '60' for '60 to 100 bpm' is 1. 1=Again (wrong, blank, or anything the card asks for left out), 2=Hard (the whole answer, but slowly or unsurely), 3=Good (the whole answer), 4=Easy (the whole answer at once). 2, 3 and 4 all record that the user knew it. State the exact answer on a miss, then immediately ask next_card's front. A null next_card ends the session. Wrap up briefly.

submit_review

Use this when the user wants to study an archived deck again. Puts it back into study: its cards come back with the review history they had, so whatever came due while it was archived is due now, within the daily limits. Its subdecks come back with it, and so do the decks it sits in.

unarchive_deck

Use this when the user asks to fix, reword, correct or retag cards they already have. Changes 1-500 cards atomically: give card_id and only the fields to change (front_html, back_html, tags); the rest stay, cards keep their schedule and review history, and restore_cards can undo the edit. Read list_cards first; for a shared source copy its sibling_card_ids, one edit per source. The note type stays; an edit that would remove cards is refused (use delete_cards). Follow create_cards' field notes.

update_cards