POST
/api/v1/documents/{slug}/commentsStart a thread
Comments on quoted text (anchor.type: text with quote.exact and the characters around it), a whole block (block, by block_id or block_text) or the page (page). mentions are user ids of people who can open it; assignee makes it a task. The page's text never changes.
Guide: Comments
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
anchorobjectRequired5 fields inside
type"text" | "block" | "page"Requiredblock_idstringUp to 40 characters.
block_textstringUp to 2,000 characters.
quoteobjectstartinteger
bodystringRequired1–5,000 characters.
mentionsarray of stringUp to 20 items.
assigneestringUp to 40 characters.
attachmentsarray of stringUp to 10 items.
suggestionstringUp to 5,000 characters.
Responses
#201Created.401No token, or the token is revoked or mistyped.422The quoted text or block isn't on the page (codeanchor_not_found), or the comment is empty or too long.429Too many requests from your IP address. Wait the seconds inRetry-After.