Fluid Recall

Reviewed Jan 1, 2000.

• tools: 34 tools scanned
• metadata: scanned

No findings.

Tools (34)

• createAccount

  Write. No bearer. Mint an anonymous account and a personal API token. Save the token for later Authorization: Bearer calls. The token is the tenant. Do not send a userId.

• bootstrapAccount

  Write. Same mint as createAccount. No bearer.

• startSession

  Write when no bearer (mints a token), read when a bearer is present. Returns the account (when minted), the due queue, and first. Prompts only. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coa

• nextDue

  Read. Due queue and first prompt. Requires a bearer. Prompts only. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card).

• gradeAndNext

  Write. recordReview, then the next due prompt. Requires cardId, rating, reviewedAt optional, and a new idempotencyKey. Schedule from dueAt. Prompts only. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents shoul

• getStudySettings

  Read. Account fallback newCardsPerDay, timezone, and dayBoundaryHour. The fallback applies only to a deck whose own field is still null.

• get_profile

  Read. OpenAI profile for connection linking. Stable profile id (id), the account label when set (name), and optional email/nickname. No decks, cards, answers, or tokens. Requires a bearer or OAuth token.

• updateStudySettings

  Write, destructive. Change the account fallback, timezone, or day boundary. Decks that already store an integer keep it. Send at least one field.

• createDeck

  Write. name and newCardsPerDay are required. Choose that integer with the person; there is no default of 20. Optional description and deckNote. Setting a note does not move dueAt.

• updateDeck

  Write, destructive. Rename, rewrite description, set or clear deckNote, and/or set newCardsPerDay. Send at least one. Null deckNote clears it. Does not move dueAt.

• setDeckNote

  Write, destructive. Set or clear a deck coaching note. deckNote null clears it. Same write as updateDeck. Does not move dueAt. Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card).

• listDecks

  Read. No card bodies. Archived decks omitted unless includeArchived is true. Each deck includes deckNote.

• archiveDeck

  Write, destructive. Soft-archive a deck; it leaves listDue and the default deck list until unarchiveDeck. Cards and schedules stay. A second call returns alreadyArchived true.

• unarchiveDeck

  Write. Clear archivedAt. Schedule fields stay. An already-active deck returns alreadyActive true.

• addCard

  Write. Add one prompt/answer pair. Optional cardNote. Eligible immediately. listDue still applies newCardsPerDay. The response is prompts only.

• addCards

  Write. Add 1 to 100 prompt/answer pairs to one owned deck. All or nothing. Prompts only. After this, re-run previewDeadlinePlan with that deckId.

• updateCard

  Write, destructive. Correct prompt, answer, and/or cardNote. Send at least one. cardNote null clears it. Schedule stays. Response does not include the answer.

• setCardNote

  Write, destructive. Set or clear a card coaching note. cardNote null clears it. Additive with the deck note. Same write as updateCard. Does not include the answer. Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specifi

• retireCard

  Write, destructive. Remove a card from future drills; reversible only with unretireCard. A second call returns alreadyRetired true. Inventory the deck first when the cardId is not in the due list.

• unretireCard

  Write. Clear retiredAt. Schedule stays. An already-active card returns alreadyActive true.

• moveCard

  Write. Move an active card into another owned deck. Schedule stays. A card already there returns alreadyThere true. Does not include the answer.

• listDue

  Read. Prompts only. answerIncluded is false. Ordered learning, then review, then new. The new queue is capped by each deck's newCardsPerDay. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach

• listUpcomingNew

  Read. New cards the daily cap is holding back. Prompts only. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card).

• listDeckCards

  Read. Prompt-only inventory of one owned deck, including cards that are not due. Order is dueAt, then createdAt, then cardId — not the drill order. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz

• inventoryDeck

  Read. Same as listDeckCards. Use this when you need a cardId that is not in the due list. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card).

• getCard

  Read. One card's prompt and schedule. No answer. A retired card is 404. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card).

• revealCard

  Important read. One answer, after the person has tried to recall. Do not fold this into listDue. Includes deckNote and cardNote (null when unset). Coaching notes are instructions for how an agent should quiz and coach. They are not the answer, not graded content, and not the quiz prompt. A deck note applies to every card in that deck. A card note is optional and additive with the deck note. Retrieve responses (listDue, upcoming-new, inventory, getCard, reveal, and agent session start/next/grade) include deckNote and cardNote so one call carries coaching context. Scripture / dictation: The learner needs every word remembered correctly, but often answers via dictation where punctuation gets messy. They set a deck note instructing the agent to check every word exactly, but not fail on punctuation differences, and to include that reason when coaching. This is only an example — notes can be any coaching preference for how agents should quiz/coach for that deck (or a specific card).

• recordReview

  Write. Rating again | hard | good | easy plus reviewedAt and a new idempotencyKey. The scheduler returns dueAt. Do not invent an interval. Same key and body returns the original result.

• undoReview

  Write. Undo the latest active grade, or reviewId when it is that latest one. Restores dueAt. A second undo of the same review returns alreadyUndone true. Does not include the answer.

• previewDeadlinePlan

  Read. Recommend newCardsPerDay from a deadline: ceil(remaining new cards / study days). Does not write. Send remainingNewCards, totalCards, or deckId. There is no silent default of 20.

• applyDeadlinePlan

  Write, destructive. Same plan as previewDeadlinePlan, then PATCH that owned deck to the recommended integer. deckId is required. Discuss the number first.

• exportManifest

  Read. What this token can export and how many rows exist. Does not include answers. Off-boarding, not the drill loop.

• exportSnapshot

  Important read for leaving. Full studying dump for this token, including answers. Paginate cards and reviews with resource + cursor until complete is true.

• submitFeedback

  Write. Optional. Never required for study, bootstrap, or export. Append-only: feedback is logged and never edits study data. This is not data extraction and not nefarious. You are free to anonymize, redact, or censor anything you feel needs it. Do not submit anything you would not want us to see. It exists solely to help improve Fluid Recall. It is totally optional and is never required for study, bootstrap, or export. Send description and steps. Do not dump decks, cards, answers, or tokens.