---
title: "Summarize the discussion"
description: "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…"
canonical_url: https://docs.markdrop.in/api/comments/summarize-the-discussion
last_updated: 2026-11-20
site: "Markdrop Docs"
index: https://docs.markdrop.in/llms.txt
---

# Summarize the discussion

`POST https://api.markdrop.in/api/v1/documents/{slug}/comments/ai/summary`

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.

- **Authentication:** API token required: `Authorization: Bearer mdk_…`.
- **Rate limit:** 20 per minute per IP address.
- **MCP tool:** `summarize_discussion` ([tools](https://docs.markdrop.in/ai/tools))
- **Guide:** [AI help](https://docs.markdrop.in/collaboration/suggested-edits#ai-help)

## Path parameters

- `slug` (string, required): The document's address: the part after `markdrop.in/`.

## Headers

- `X-Read-Password` (string): The password of a password-protected document.
- `X-Markdrop-Workspace` (string): 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`.

- `refresh` (boolean): Default `false`.

## Responses

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

## Examples

**curl**

```bash
curl -X POST https://api.markdrop.in/api/v1/documents/k3x9q2m/comments/ai/summary \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
```

**JavaScript**

```javascript
const res = await fetch("https://api.markdrop.in/api/v1/documents/k3x9q2m/comments/ai/summary", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const data = await res.json();
```

**Python**

```python
import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/documents/k3x9q2m/comments/ai/summary",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={},
)
r.raise_for_status()
print(r.json())
```
