Save a word to Koboshi
save_wordAdds one word, phrase or idiom to the user's own Koboshi vocabulary, so their spaced-repetition reviews bring it back. The word is saved in the one language it is written in. Koboshi looks it up as part of this call: when it already holds a card the save completes, and when it is new the result carries the card rules and the call is repeated with the finished card. Saving the same word twice does not create a second entry. One call saves the one word it was given and nothing else, unless "save_languages" names the words the user picked. Several different words from one request belong in save_words instead. A saved phrase or idiom counts one word for every 10 words it holds toward the account's 100-word daily limit, so a long one can use up more than one. The result shows the word in every language on the account, for reading. Cards Koboshi lacks are written by the AI in the chat from Koboshi's rules and sent in "translations"; Koboshi checks them and keeps them for its own review, and they add nothing to the vocabulary by themselves. Optional: "sense" names which meaning of an ambiguous word was wanted: a new word is saved with it, and a word already saved adds that meaning (its first meaning stays); "context_sentence" keeps the sentence the word appeared in as the user's own private example.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card | No | The card you wrote, only needed when the word is new to Koboshi. | |
| word | Yes | The word, phrase or idiom to save, written in its own language. | |
| sense | No | Which meaning the user wants, in a few words, e.g. "the body-tissue sense, not the paper one". Only when they have said so. For a word they already saved it adds that meaning as one more, keeping the first. | |
| concept | No | The shared English label for this meaning, one word where one exists: "echo" covers yamabiko, eco and goonj alike. Koboshi links words carrying the same label, so the user sees this word beside the same concept in their other languages. | |
| translations | No | Cards for this word in the account's other languages, written from the translation card rules a result gave, one per language, each with "language". Koboshi keeps them for its check; they reach the vocabulary only through save_languages. | |
| save_languages | No | The languages of the words the user picked from the result: the word itself and its words in the account's other languages. Given, it is the whole list: the word in each language named is saved, and the word itself only when its own language is in the list. Left out, the save covers the one word. | |
| context_sentence | No | The sentence the word appeared in, when it came from text in this conversation. Kept as the user's own example on their saved word: private to them and never added to the shared dictionary. Up to 500 characters. | |
| primary_language | No | ||
| learning_language | No |