Commits a previously previewed or freshly supplied Lingard vocabulary change. Unless allowIncompleteCards is true, a new card needs title, translate, pos, pron/ipa, syns, and examples with translations; image is optional. A German or Romance noun title carries its dictionary article when one is used, e.g. der Hund, die Reise, das Haus. In example text and example translation the target word and the translated word are marked with {}. form is not part of speech: it holds the inflected-form category of the current word and stays empty for base forms. This is the tool that corrects existing cards: mergeMode:"overwrite_non_empty" replaces values that are already filled in and clearFields:["form"] clears a wrong grammatical form, which is why it is marked destructive.
View input schema
{
"type": "object",
"properties": {
"targetLang": {
"type": "string"
},
"change": {
"type": "object",
"additionalProperties": true,
"properties": {
"targetLang": {
"type": "string"
},
"collectionUuid": {
"type": "string"
},
"collectionTitle": {
"type": "string"
},
"title": {
"type": "string"
},
"topic": {
"type": "string"
},
"color": {
"type": "string",
"description": "Optional Lingard collection color. Accepts Swift raw hex like ff9500 or names like orange."
},
"pic": {
"type": "string",
"description": "Optional Lingard standard collection icon raw value, for example collection.plane or plane."
},
"icon": {
"type": "string",
"description": "Alias for pic."
},
"mergeMode": {
"type": "string",
"enum": [
"fill_missing",
"overwrite_non_empty",
"add_only"
]
},
"createIfMissing": {
"type": "boolean"
},
"allowIncompleteCards": {
"type": "boolean",
"description": "Default false. True marks the change as a sparse or exact import that the user asked for; it lets cards through without the complete-card fields (title, translate, pos, pron/ipa, syns, examples with translations, the dictionary article on a German/Romance noun title, {} highlights in examples). form is needed only when the current word is an inflected form."
},
"cards": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"description": "Lingard vocabulary card. A complete card has title/word, translate/translation, pos, pron or ipa, syns/synonyms, and examples with translations; image is optional. German, Spanish, French, Italian, and Portuguese noun titles carry their dictionary article when one is used, e.g. German: der Hund, die Reise, das Haus; pron/ipa never includes the article. In every example the target word is wrapped in {}, and in the example translation the translated word is wrapped in {}. form holds the current inflected-form category and is empty for base forms.",
"properties": {
"title": {
"type": "string",
"description": "Word or phrase in the target language. A noun in a language with grammatical gender carries its dictionary article when one is used, e.g. German der Hund / die Reise / das Haus, Spanish el aeropuerto / la ciudad, French le livre / la maison."
},
"word": {
"type": "string",
"description": "Alias for title; a German/Romance noun carries its article here too."
},
"translate": {
"type": "string",
"description": "Translation into the user native language."
},
"translation": {
"type": "string",
"description": "Alias for translate."
},
"pos": {
"type": "string",
"description": "Part of speech, for example noun, verb, adjective, adverb, phrase."
},
"pron": {
"type": "string",
"description": "Pronunciation or IPA transcription (for English: IPA or a clear phonetic transcription)."
},
"ipa": {
"type": "string",
"description": "Alias for pron; IPA transcription."
},
"form": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Current inflected-form category, not part of speech. English values: past, present participle, past participle, 3rd sg. present, plural, comparative, superlative. A base/unmarked form, singular noun, phrase, or word with no category has no form (field omitted or null)."
},
"syns": {
"type": "array",
"description": "Synonyms or close alternatives in the target language; a complete card has at least one.",
"items": {
"type": "string"
}
},
"synonyms": {
"type": "array",
"description": "Alias for syns.",
"items": {
"type": "string"
}
},
"examples": {
"type": "array",
"description": "Example sentences or collocations with translations, as objects with c/collocate/example and t/translate/translation. The target word in the example and the translated word in the translation are wrapped in {}, for example c:\"I missed my {flight}.\", t:\"Я опоздал на свой {рейс}.\". A translation is required; t:\"\" (or null) stores the example with an empty translation line, for examples the user wants untranslated.",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"c": {
"type": "string"
},
"collocate": {
"type": "string"
},
"example": {
"type": "string"
},
"t": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Translation line. Empty string or null stores the example without a translation."
},
"translate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"translation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"e": {
"type": "boolean"
},
"enabled": {
"type": "boolean"
}
}
}
]
}
},
"clearFields": {
"type": "array",
"description": "[\"form\"] clears an existing incorrect grammatical form when the current word is base/unmarked. Only form is supported.",
"items": {
"type": "string",
"enum": [
"form",
"grammatical_form",
"formType",
"form_type"
]
}
},
"allowMissingArticle": {
"type": "boolean",
"description": "True for proper nouns, fixed terms, or exceptional nouns that are used without a dictionary article."
}
}
}
},
"words": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"description": "Lingard vocabulary card. A complete card has title/word, translate/translation, pos, pron or ipa, syns/synonyms, and examples with translations; image is optional. German, Spanish, French, Italian, and Portuguese noun titles carry their dictionary article when one is used, e.g. German: der Hund, die Reise, das Haus; pron/ipa never includes the article. In every example the target word is wrapped in {}, and in the example translation the translated word is wrapped in {}. form holds the current inflected-form category and is empty for base forms.",
"properties": {
"title": {
"type": "string",
"description": "Word or phrase in the target language. A noun in a language with grammatical gender carries its dictionary article when one is used, e.g. German der Hund / die Reise / das Haus, Spanish el aeropuerto / la ciudad, French le livre / la maison."
},
"word": {
"type": "string",
"description": "Alias for title; a German/Romance noun carries its article here too."
},
"translate": {
"type": "string",
"description": "Translation into the user native language."
},
"translation": {
"type": "string",
"description": "Alias for translate."
},
"pos": {
"type": "string",
"description": "Part of speech, for example noun, verb, adjective, adverb, phrase."
},
"pron": {
"type": "string",
"description": "Pronunciation or IPA transcription (for English: IPA or a clear phonetic transcription)."
},
"ipa": {
"type": "string",
"description": "Alias for pron; IPA transcription."
},
"form": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Current inflected-form category, not part of speech. English values: past, present participle, past participle, 3rd sg. present, plural, comparative, superlative. A base/unmarked form, singular noun, phrase, or word with no category has no form (field omitted or null)."
},
"syns": {
"type": "array",
"description": "Synonyms or close alternatives in the target language; a complete card has at least one.",
"items": {
"type": "string"
}
},
"synonyms": {
"type": "array",
"description": "Alias for syns.",
"items": {
"type": "string"
}
},
"examples": {
"type": "array",
"description": "Example sentences or collocations with translations, as objects with c/collocate/example and t/translate/translation. The target word in the example and the translated word in the translation are wrapped in {}, for example c:\"I missed my {flight}.\", t:\"Я опоздал на свой {рейс}.\". A translation is required; t:\"\" (or null) stores the example with an empty translation line, for examples the user wants untranslated.",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"c": {
"type": "string"
},
"collocate": {
"type": "string"
},
"example": {
"type": "string"
},
"t": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Translation line. Empty string or null stores the example without a translation."
},
"translate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"translation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"e": {
"type": "boolean"
},
"enabled": {
"type": "boolean"
}
}
}
]
}
},
"clearFields": {
"type": "array",
"description": "[\"form\"] clears an existing incorrect grammatical form when the current word is base/unmarked. Only form is supported.",
"items": {
"type": "string",
"enum": [
"form",
"grammatical_form",
"formType",
"form_type"
]
}
},
"allowMissingArticle": {
"type": "boolean",
"description": "True for proper nouns, fixed terms, or exceptional nouns that are used without a dictionary article."
}
}
}
}
}
}
},
"required": [
"targetLang",
"change"
]
}