Check Text
POST /api/writing/worldspell/check
Check text for grammar issues with voice profile suppression.
Routes through DivinityExecutor / :class:WorldspellCheckHandler
after Phase A12 of the M15 migration; the legacy direct-service
fallback was retired with the LLM provider stack.
Request Body required
Section titled “Request Body required ”Request to check text with WorldSpell.
Responses
Section titled “ Responses ”Successful Response
Complete WorldSpell check result for a document or passage.
object
All violations (including suppressed)
A single grammar issue from LanguageTool, with suppression metadata.
object
LanguageTool rule ID
Human-readable rule description
Rule category (e.g. Grammar, Typos, Style)
Severity: error, warning, or info
Violation message
Text context around the violation
Character offset in the checked text
Length of the flagged text
Line number in the checked text
Column number in the checked text
The actual flagged text extracted from the document
Suggested replacements
True if suppressed by a voice profile or dictionary
Count of violations NOT suppressed
Count of violations suppressed by voice profiles
Voice profiles active in scope for this check
Metadata about a voice profile active in scope for this check.
object
Profile identifier (e.g. ‘character:uuid’, ‘document:uuid’)
Human-readable name (character name or document title)
Whether this profile comes from a Legendry character or a document
Number of custom dictionary words that suppressed violations
Number of violations suppressed by Legendry title words
Number of violations suppressed by built-in allowlists (classical plurals, etc.) — the words most authors would otherwise have to add to their custom dictionary manually.
Legendry-derived words used for spelling suppression
ISO timestamp of the check
Validation Error