POST
/api/v1/documents/{slug}/comments/ai/toneCheck a comment's tone
Whether a draft comment reads clear and kind, with a suggested rewrite when it doesn't. Only drafts that look harsh reach AI unless force is true.
API token required30 per minute per IP
Guide: AI help
Code samples and Try itPath parameters
#slugstringRequiredThe document's address: the part after
markdrop.in/.
Headers
#X-Read-PasswordstringThe password of a password-protected document.
X-Markdrop-WorkspacestringA workspace's id: answer only if the document is in that workspace, else
404. Workspace domains send it; you rarely need it.
Request body
#application/json, required
bodystringRequired1–5,000 characters.
forcebooleanDefault
false.
Responses
#200OK.401No token, or the token is revoked or mistyped.422The request didn't validate.detaillists each problem, with where it is (loc) and why (msg).429Too many requests from your IP address. Wait the seconds inRetry-After.