Flash

Archive a deck the user is done with (an exam passed): every card, its media and its review history stay, but the deck leaves the study queue and the due counts, and start_study_session on it finds nothing. Nothing is deleted, so no confirmation is needed; unarchive_deck reverses it. Its subdecks are archived with it. Cards can still be added to an archived deck by name.

archive_deck

Use to add flashcards the user asks for, from their notes, a document, a topic or this conversation. Creates 1-500 cards in one deck (created if missing, with its parents when named Parent::Child), atomically. Follow the field notes to write cards worth learning from. Cloze uses {{c1::answer}}. Keep media references as /media/{id} (IDs from list_cards). To fix cards that exist, use update_cards rather than adding copies. Returns the card IDs and counts.

create_cards

Create a new (empty) deck. Name it Parent::Child to make a subdeck; parents that do not exist are created too. Not needed before create_cards, which creates its deck.

create_deck

Delete 1-500 explicit card IDs with one confirmation for the batch. First call returns the exact set and confirm_token, deleting nothing. Ask the user once; after approval repeat the same card_ids with confirm_token. Tokens last ten minutes and survive reconnects. A completed retry returns its original result.

delete_cards

Permanently delete a deck, every subdeck under it (Parent::Child names) and all their cards. First call returns decks_affected, the exact affected card IDs/count and confirm_token without deleting. Name every affected deck to the user, ask once, then repeat the same deck and token. Tokens last ten minutes across reconnects. A changed card or subdeck requires a fresh confirmation. Completed retries return the original result.

delete_deck

End a study session and get its summary (counts by rating and total reviewed). Give the user a one-sentence recap.

end_session

Show today's study limits: the account defaults (new cards per day, max reviews per day, any extra new cards granted today) and every deck's override (null = inherits) with how many new and due cards it can still serve today.

get_limits

Read complete cards and editable sources, with formatting and authenticated media URLs. GET media URLs with the same connector Bearer token; do not speak URLs or markup. Source contains cloze answers: use study tools when quizzing. Shared source edits affect sibling_card_ids. Results are newest first; follow next_cursor as before_card_id while has_more. Default limit 50, max 500; a page of large cards may hold fewer than limit, so trust has_more, not the count.

list_cards

List the user's decks with due and new card counts. A name is a path: Parent::Child is a subdeck of Parent, and each deck is followed by its subdecks. A deck's counts already include its subdecks, so never add rows up. An archived deck keeps its place, with archived: true and zero counts.

list_decks

List the user's tags with how many cards carry each, in one deck (and its subdecks) or across every deck. Use the names as start_study_session's tags to study one corner of a deck, such as a chapter or an exam.

list_tags