Health check: confirm AnkiConnect is reachable and return its API version (expected: 6). Call this first if other tools are failing.

Ask AnkiConnect whether this client is permitted to make requests. Returns the permission status (and requires user approval in Anki the first time if an origin allow-list is configured).

List every AnkiConnect action supported by the running Anki/add-on version (via apiReflect). Useful to discover capabilities or debug.

Sync the local collection with AnkiWeb (so changes reach AnkiDroid / other devices). Requires AnkiWeb login configured in Anki Desktop.

Tell Anki to reload the collection from disk.

List the names of all Anki user profiles.

Return the name of the currently active Anki profile.

Switch Anki to the given user profile.

Export a deck to an .apkg file at 'path'. Set include_sched=True to keep scheduling info (due dates, review history).

Import an .apkg package file from 'path' into the collection.

Escape hatch: call ANY AnkiConnect action by name with raw params. Use only when no dedicated tool covers what you need (e.g. a brand-new AnkiConnect action). 'params' must match AnkiConnect's exact keys.

List the names of all decks in the collection.

List all decks as a map of deck name -> deck ID.

Given card IDs, return a map of deck name -> the card IDs it contains.

Create a new deck. Use '::' in the name to create a nested subdeck (e.g. 'Languages::Romanian'). Existing decks are left untouched.

Delete a deck. If cards_too is True (default) its cards are deleted as well; otherwise the cards are moved to the Default deck. Irreversible.

Move the given cards to another deck. The target deck is created automatically if it does not exist. Note: in Anki you move cards, not notes — get card IDs from find_cards, or from the cards field returned by find_notes.

Get review statistics (new/learning/review counts, totals) for the given deck names.

Get the options/config group for a deck (new/review limits, intervals, etc.).

Save a modified deck options group. Pass a config object previously obtained from get_deck_config with your changes applied.

Assign the given decks to an existing options group by its config ID.

Create a new options group named 'name', optionally cloned from an existing group's config ID. Returns the new config ID (or False).

Remove an options group by its config ID (decks using it revert to the default group).

List all note type (model) names, e.g. 'Basic', 'Cloze'.

List all note types as a map of model name -> model ID.

Get full definitions (fields, templates, css) for note types by ID.

Get full definitions (fields, templates, css) for note types by name.

List the field names of a note type, in order (e.g. Basic -> ['Front', 'Back']). Use this before add_note to supply the right fields.

List each field's description (placeholder text) for a note type.

Return the editor font and size configured for each field of a note type.

Return, per card template, which fields appear on the front and back.

Create a new note type. 'fields' are the ordered field names. 'card_templates' is a list of {'Name','Front','Back'} template dicts whose Front/Back are HTML using {{Field}} placeholders. Optional 'css' styles the cards; set is_cloze=True for a cloze-deletion type.

Return the card templates (Front/Back HTML) of a note type.

Return the CSS styling of a note type.

Update card templates of a note type. 'templates' maps template name -> {'Front': html, 'Back': html}.

Replace the CSS styling of a note type.

Find & replace text within a note type's templates/css. Toggle which parts to touch with front/back/css.

Rename a card template within a note type.

Move a card template to a new position (0-based index).

Add a card template to a note type. 'template' is {'Name','Front','Back'}.

Remove a card template from a note type. Irreversible.

Rename a field of a note type.

Move a field to a new position (0-based index).

Add a new field to a note type, optionally at a 0-based index.

Remove a field from a note type. Irreversible (data in it is lost).

Set the editor font of a field.

Set the editor font size of a field.

Set the description (placeholder text) of a field.

Add a single note. 'fields' maps the note type's field names to their HTML/text values (e.g. {'Front': '...', 'Back': '...'}). The deck and note type (model) must already exist. Returns the new note ID.

Add many notes in one call. Each item is {'deck': str, 'model': str, 'fields': {..}, 'tags': [..]?, 'allow_duplicate': bool?}. Returns a note ID per note (null where a note could not be added, e.g. a duplicate).

Check whether notes could be added (without adding them). Same note shape as add_notes. Returns a list of booleans plus per-note error detail.

Search notes with Anki's query syntax (e.g. 'deck:Default tag:new'). Returns the total count, all matching note IDs, and detailed field data for up to 'limit' notes.

Get detailed info (fields, tags, model, cards) for specific note IDs.

Get the last-modified timestamp for specific note IDs.

Update one or more fields of an existing note. Only the fields you pass are changed; omitted fields keep their current values.

Update fields and/or the full tag set of a note in one call. Pass 'fields' to change fields and/or 'tags' to REPLACE the note's tags.

Replace the entire tag set of a note with 'tags'.

Get the tags of a single note.

Permanently delete the given notes (and all their cards). Irreversible.

Delete all notes that have no cards (empty notes). Irreversible.

List every tag used anywhere in the collection.

Add one or more tags to the given notes.

Remove one or more tags from the given notes.

Delete tags that are no longer used by any note.

Rename a tag on the given notes (replace old_tag with new_tag).

Rename a tag across the ENTIRE collection (replace old_tag with new_tag on every note).

Search cards with Anki's query syntax. Returns the total count, all matching card IDs, and detailed info (deck, note, interval, due, suspended state) for up to 'limit' cards.

Get detailed info for specific card IDs (deck, fields, interval, due, ease, review count, suspended/marked state).

Map card IDs to their parent note IDs (deduplicated).

Get the last-modified timestamp for specific card IDs.

Suspend the given cards so they stop appearing in reviews.

Unsuspend the given cards so they return to the review queue.

For each card ID, return True if suspended, False if not, null if the card does not exist.

For each card ID, return whether it is currently due for review.

Get the current interval of each card. With complete=True, returns the full list of all intervals in each card's history instead.

Get the ease factor (per mille, e.g. 2500) of each card.

Set the ease factor of each card (parallel lists). Ease is per mille, e.g. 2500 = 250%.

Advanced: set specific low-level fields of one card (parallel keys/ values lists). Use with care — writing raw card properties can corrupt scheduling if misused.

Reset cards to the 'new' state (forget all review progress).

Put the given cards into the relearning queue.

Reschedule cards to be due in 'days'. 'days' is Anki's set-due-date spec: '0' = today, '3' = in 3 days, '1-7' = random within a range, add '!' (e.g. '3!') to also reset the interval to that value.

Programmatically answer cards as if reviewed. Each item is {'cardId': int, 'ease': 1-4} where 1=Again, 2=Hard, 3=Good, 4=Easy.

Store a media file (image/audio) in the collection's media folder so it can be referenced from a note, e.g. '[sound:word.mp3]' or ''. Provide exactly one source: a local 'path', a 'url' to download, or base64 'data_b64'. Returns the stored filename.

Retrieve a media file's contents as base64 (or false if not found).

List media file names, optionally filtered by a glob pattern (e.g. '*.mp3').

Return the absolute path of the collection's media folder.

Delete a file from the collection's media folder. Irreversible.

Return how many cards have been reviewed so far today.

Return review counts per day as [date_string, count] pairs.

Return Anki's statistics report as an HTML string.

Return all review log entries for a deck made after the given review ID (a Unix-ms timestamp; use 0 for all).

Return the full review history for specific card IDs.

Return the most recent review ID for a deck (0 if none).

Insert raw review-log rows (advanced; each row is AnkiConnect's review tuple). Mainly for migrating history.

Open Anki's Card Browser filtered by 'query' and return the shown card IDs. Anki must be in the foreground to see it.

Return the note IDs currently selected in the open Card Browser.

Open Anki's Add dialog pre-filled with the given note (does not save it automatically). Returns the note ID if the user confirms.

Open the Edit dialog for a specific note.

Return info about the card currently shown in the reviewer (or null).

Show the question side of the current reviewer card.