Flashcards
The flashcards endpoints of the Lifous API.
A * marks a required field. Path fields go in the address, query fields after a ?, body fields in JSON.
/api/v1/flashcards/decksYour decks
Every deck with how many cards are new, learning and due now.
| Field | In | Type | Meaning |
|---|---|---|---|
| timezone | query | IANA zone | Which calendar day "today" is. Your account’s zone when omitted. |
MCP tool: list_decks
/api/v1/flashcards/decksMake a deck
A flashcard deck of your own. Names are unique among your decks. Plan limits apply (Free 3, Pro 20, Max unlimited).
| Field | In | Type | Meaning |
|---|---|---|---|
| name * | body | string | Up to 100 characters. |
| description | body | string | Up to 500 characters. |
{ "name": "German words", "description": "Everyday vocabulary" }MCP tool: create_deck
/api/v1/flashcards/decks/{id}Rename or set up a deck
Change a deck’s name, description or how many new cards a day it introduces. Only the fields sent change.
| Field | In | Type | Meaning |
|---|---|---|---|
| id * | path | uuid | One of your decks. |
| name | body | string | Up to 100 characters. |
| description | body | string | Up to 500 characters. |
| newPerDay | body | integer | New cards a day, 0–999 (20 when a deck is made). |
{ "name": "German words (A2)", "newPerDay": 10 }MCP tool: update_deck
/api/v1/flashcards/dueCards due in a deck
The study queue of one deck: the cards due now, rendered front and back.
| Field | In | Type | Meaning |
|---|---|---|---|
| deck * | query | uuid | The deck. |
| timezone | query | IANA zone | Which calendar day "today" is. Your account’s zone when omitted. |
MCP tool: due_flashcards
/api/v1/flashcardsAdd a flashcard
A basic card (front and back) or a cloze (`{{c1::…}}` in the front) in one of your decks. Plan limits apply.
| Field | In | Type | Meaning |
|---|---|---|---|
| deckId * | body | uuid | One of your decks. |
| front * | body | string | The question, or the cloze text. |
| back | body | string | The answer; not used by a cloze. |
| type | body | basic | cloze | basic when omitted. |
| tags | body | string[] |
{ "deckId": "…", "front": "Capital of Portugal?", "back": "Lisbon" }MCP tool: add_flashcard
/api/v1/flashcardsCards in a deck
The cards of one of your decks, newest first: id, type, front, back and tags. `query` matches the front, the back or a tag. Use the ids to move or delete cards.
| Field | In | Type | Meaning |
|---|---|---|---|
| deckId * | query | uuid | One of your decks. |
| query | query | string | Words to match, case aside. |
| limit | query | integer | 1–200; 50 when omitted. |
| offset | query | integer | Cards to skip; 0 when omitted. |
{ "cards": [{ "id": "…", "type": "basic", "front": "die Abmachung", "back": "agreement", "tags": [] }], "total": 30 }MCP tool: list_flashcards
/api/v1/flashcards/moveMove cards to another deck
Up to 100 of your cards, by id, into one of your decks. Each keeps its schedule and history. Ids that are not yours are skipped; `moved` says how many moved.
| Field | In | Type | Meaning |
|---|---|---|---|
| ids * | body | uuid[] | 1–100 card ids from list_flashcards. |
| deckId * | body | uuid | The deck to move them into. |
{ "ids": ["…", "…"], "deckId": "…" }MCP tool: move_flashcards
/api/v1/flashcardsDelete cards
Up to 100 of your cards, by id, for good — with their review history. Learning XP already earned stays. Ids that are not yours are skipped.
| Field | In | Type | Meaning |
|---|---|---|---|
| ids * | query | uuid list | 1–100 card ids, separated by commas. |
MCP tool: delete_flashcards