---
title: "Magic Summarize"
method: POST
path: "/v1/summarize"
tags: ["Summarize"]
---

# Magic Summarize

`POST /v1/summarize`

Generate an AI-powered summary from a collection of highlights, data entries (notes), insights, themes, and/or tags. Provide one or more arrays of IDs and Dovetail will synthesize the content into a concise summary.

At least one of `highlight_ids`, `note_ids`, `insight_ids`, `theme_ids`, or `tag_ids` must contain at least one item. The `note_ids` field accepts data entry IDs (the product now calls these "data" rather than "notes").

Set `with_citations` to `true` (default) to include citation references in the summary. Each citation links back to the specific source item (highlight, data entry, insight, theme, or tag) that contributed to that part of the summary.

Returns a summary string and an array of citations with their source IDs and types.

## Request body

- object
  - `highlight_ids` string[] — A list of unique highlightIds that you wish to summarize.
  - `note_ids` string[] — A list of unique noteIds that you wish to summarize.
  - `insight_ids` string[] — A list of unique insightIds that you wish to summarize.
  - `theme_ids` string[] — A list of unique themeIds that you wish to summarize.
  - `tag_ids` string[] — A list of unique tagIds that you wish to summarize.
  - `with_citations` boolean — An optional flag whether to show citations or not, true by default.

## Response `200`

200

- object
  - `data` object, required
    - `summary` string, required
    - `citations` object[], required
      - `id` string, required
      - `type` 'HIGHLIGHT' | 'INSIGHT' | 'NOTE' | 'THEME' | 'TAG', required
      - `citation_id` number, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/revisions/4107f5fdf8b2/schema)