Add a card
add_cardAdd a card to your LingoChunk review queue: choose 'vocab' to attach a known word by lemma, or 'custom' to create a freeform card with front and back text.
Instructions
Add a card to the user's LingoChunk review queue (FSRS; it starts as 'new'). kind=vocab adds a word the user ALREADY has in their vocabulary, resolved by lemma against their own content (404 if the lemma is not in their vocabulary; 409 code=ambiguous_lemma if it occurs in several episodes or under several parts of speech, so pass submission_id or pos as the message names). kind=custom adds a freeform card and REQUIRES front, back and submission_id (the episode it anchors to); pass sentence_position to anchor its example to a specific transcript sentence. Omit deck_id and the card goes to the deck for its own submission (the same deck the app builds, reviews and exports that episode from, so it is immediately visible and exportable); an explicit deck_id must belong to that submission (400 otherwise). A 409 code=duplicate_card means the card already exists: expected, not worth retrying. NOTE: deleting the anchoring episode deletes the card (cascade), and a card added while the app's Words tab is open on that episode may be overwritten by the app's own save, so add cards when the app is not actively editing that deck. Requires the cards:write scope.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pos | No | Part of speech, to disambiguate the lemma (kind=vocab); case-insensitive. | |
| back | No | Back/answer text (kind=custom; max 500 chars). | |
| kind | Yes | vocab = a word from your vocabulary; custom = freeform front/back. | |
| note | No | Optional note shown on the card (kind=custom; max 300 chars). | |
| front | No | Front/prompt text (kind=custom; max 200 chars). | |
| lemma | No | Dictionary form to add (kind=vocab). | |
| deck_id | No | Target deck id from list_decks; omit to use the deck for the card's own submission. When given, it must belong to that submission. | |
| submission_id | No | Disambiguate the lemma to one episode (kind=vocab); the episode the card anchors to (REQUIRED for kind=custom). | |
| sentence_position | No | 1-based transcript position (see get_transcript) to anchor a custom card's example; defaults to the submission's first sentence. |