POST/api/v1/documents/{slug}/comments/ai/summary

Summarize the discussion

What the item's threads decided, what's still open and who they're waiting on (open threads and those resolved in the last 30 days), each line with its thread ids. Kept until the discussion changes (cached); refresh: true asks again.

API token required20 per minute per IPMCP: summarize_discussion

Guide: AI help

Code samples and Try it

Path parameters

#
  • slugstringRequired

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

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

  • refreshboolean

    Default false.

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?