GET/api/v1/documents/{slug}/comments/people

People to mention

Who a comment can @mention: the item's owner, its workspace's members, the people it's shared with and those already in its threads, each with has_access. An email address of someone who can't open it answers invite (with whether you may share it with them); it never says whether that address has an account. Emails show only to people with a relationship to the item.

API token required120 per minute per IP

Guide: Comments

Code samples and Try it

Path parameters

#
  • slugstringRequired

    The document's address: the part after markdrop.in/.

Query parameters

#
  • qstring

    Up to 200 characters.

Headers

#
  • X-Read-Passwordstring

    The password of a password-protected document.

  • X-Markdrop-Workspacestring

    A workspace's id: answer only if the document is in that workspace, else 404. Workspace domains send it; you rarely need it.

Responses

#
  • 200OK.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?