Polidict

Creates a private word group with a name and optional description. requestId makes retries idempotent. Words join a group through save_word's addGroupIds. Subject to the plan's group limit.

Deletes one word group. Its words stay saved and only their membership in this group is removed. Requires the group's latest version. requestId makes retries idempotent.

Permanently deletes one saved word with its meanings, examples, group memberships and practice progress. Requires the word's latest version from find_my_words or save_word; a stale version returns WORD_CHANGED without deleting. requestId makes retries idempotent.

Finds the learner's word groups by name, or browses them, with IDs, versions and descriptions. Results are paged; pass nextCursor to continue. A group's words are listed by find_my_words with its group ID.

Searches or browses the learner's saved words by text or group to read or edit them, with meanings, examples, notes, images, group membership, IDs and versions for save_word and delete_word. It ignores practice scheduling; get_training_items picks words to practise and get_learning_context gives an account overview. Results are paged; pass nextCursor to continue.

Returns an account overview: the learner's languages, named word groups, a practice progress summary and the practice skills available, plus the current plan and remaining word and group capacity across all languages. It lists no individual words; find_my_words searches saved words and get_training_items picks words to practise. Capacity is a snapshot; saves enforce the current limits. planInformationUrl links to a neutral page that explains plans and limits. A word's level reflects all its meanings and its writing, listening and speaking practice. timezone is an IANA name; when omitted, dates use UTC.

Returns the connected Polidict account's ID, name, nickname and email.

Picks a batch of the learner's saved words to practise now, ten by default, for the meaning, writing, listening or speaking skills, ordered by the practice schedule. It is for running exercises; find_my_words searches saved words by text or group to read them or edit them with save_word. selection: recommended (default) returns due practice first (early steps, then the most overdue reviews), then writing, listening or speaking for words already in progress (writing only after a meaning was answered correctly), then the newest words only when nothing is due; due returns only practice due now; new returns words not yet practised in the requested skills; all ignores scheduling. Each item includes the word, its meanings and examples, practiceTargets naming the skill and meaning to practise next, and speechUrl when saved pronunciation audio exists. The returned practiceId identifies the batch for submit_training_results, and practiceGuidance states Polidict's exercise and saving rules. Read-only; an empty list means no suitable words. timezone is an IANA name; when omitted, dates use UTC.

Returns progress for one saved word. The overall level (new, learning, learned or mastered; inbox when the word has no meanings) comes from its weakest meaning or skill; learned requires every meaning plus writing, listening and speaking to be in regular reviews. Each meaning and each skill has a status (new: not practised yet and never due; learning: in short early steps; due: ready now, staying due for the rest of the learner's day; scheduled: next practice on a later date), a level, review counts and available dates. timezone is an IANA name; when omitted, dates use UTC.

Looks up a word in Polidict's public dictionary and returns meanings, translations and examples. It reads only the public catalog, never the learner's saved words, and changes nothing. A miss returns no entries.

Creates a word, or updates an existing word when itemId and expectedVersion are both provided. Matching text alone never updates an existing word. Updates are patches: omitted fields stay unchanged and null clears supported fields. definitions edits a meaning by ID or adds one without an ID; removeDefinitionIds deletes those meanings with their examples and meaning progress; removing every meaning keeps the word. Each retained meaning needs definition text or a translation. appendExamples keeps existing examples, replaceExamples replaces them ([] clears), and the two cannot be combined. addGroupIds and removeGroupIds change only the listed memberships. imageUrl accepts a durable public HTTPS image URL; null removes the image. requestId makes retries idempotent when the input is identical. Subject to the plan's word limit.

Searches stock photo providers for images that illustrate a saved word, using a short English query, and returns choices with photographer and source credits. Searching never changes the word's saved image; save_word with imageUrl sets one. Images are searched, never generated.

Saves the outcomes of practice exercises the learner actually attempted. confirmed records that the learner approved saving each included result, including failures; Polidict does not grade answers and stores the reported rating and whether it came from model assessment or learner self-assessment. Pass the batch's practiceId and a new requestId per submission; identical retries are idempotent. Each result needs the word's latest expectedVersion; a stale version returns WORD_CHANGED without saving. The response's progressSaved=true confirms the save, and updatedItems carries the new versions.

Renames a word group or changes its description; null clears the description. Requires the group's latest version. Sharing settings and the group image are preserved. requestId makes retries idempotent.