POST/api/v1/documents/{slug}/comments/{thread_id}/ai/ask

Ask Markdrop AI in a thread

Posts your question (as "@AI …") and Markdrop AI's answer in the thread, for everyone in it. The answer uses the page, the thread and pages of its workspace that everyone who can see the thread can open. Writing @AI in a comment does the same.

API token required20 per minute per IP

Guide: AI help

Code samples and Try it

Path parameters

#
  • slugstringRequired

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

  • thread_idstringRequired

    Matches ^[0-9a-f]{24}$.

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.

Request body

#

application/json, required

  • questionstringRequired

    1–1,000 characters.

Responses

#
  • 201Created.
  • 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?